tutorialspoint 


www.tutorialspoint.com 


C} https://www.facebook .com/tutorialspointindia | https://twitter.com/tutorialspoint 


Docker 


About the Tutorial 


This tutorial explains the various aspects of the Docker Container service. Starting with 
the basics of Docker which focuses on the installation and configuration of Docker, it 
gradually moves on to advanced topics such as Networking and Registries. The last few 
chapters of this tutorial cover the development aspects of Docker and how you can get up 
and running on the development environments using Docker Containers. 


Audience 


This tutorial is meant for those who are interested in learning Docker as a container 
service. This product has spread like wildfire across the industry and is really making an 
impact on the development of new generation applications. So anyone who is interested 
in learning all the aspects of Docker should go through this tutorial. 


Prerequisites 


The prerequisite is that the readers should be familiar with the basic concepts of Windows 
and the various programs that are already available on the Windows operating system. In 
addition, it would help if the readers have some exposure to Linux. 


Copyright & Disclaimer 


© Copyright 2017 by Tutorials Point (I) Pvt. Ltd. 


All the content and graphics published in this e-book are the property of Tutorials Point (I) 
Pvt. Ltd. The user of this e-book is prohibited to reuse, retain, copy, distribute or republish 
any contents or a part of contents of this e-book in any manner without written consent 
of the publisher. 


We strive to update the contents of our website and tutorials as timely and as precisely as 
possible, however, the contents may contain inaccuracies or errors. Tutorials Point (T) Pvt. 
Ltd. provides no guarantee regarding the accuracy, timeliness or completeness of our 
website or its contents including this tutorial. If you discover any errors on our website or 
in this tutorial, please notify us at contact@tutorialspoint.com. 
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Docker is a container management service. The keywords of Docker are develop, ship 
and run anywhere. The whole idea of Docker is for developers to easily develop 
applications, ship them into containers which can then be deployed anywhere. 


The initial release of Docker was in March 2013 and since then, it has become the buzzword 
for modern world development, especially in the face of Agile-based projects. 
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Features of Docker 


e Docker has the ability to reduce the size of development by providing a smaller 
footprint of the operating system via containers. 


e With containers, it becomes easier for teams across different units, such as 
development, QA and Operations to work seamlessly across applications. 


e You can deploy Docker containers anywhere, on any physical and virtual machines 
and even on the cloud. 


e Since Docker containers are pretty lightweight, they are very easily scalable. 
Components of Docker 


Docker has the following components 


e Docker for Mac - It allows one to run Docker containers on the Mac OS. 


e Docker for Linux - It allows one to run Docker containers on the Linux OS. 
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e Docker for Windows - It allows one to run Docker containers on the Windows 
OS. 


e Docker Engine - It is used for building Docker images and creating Docker 
containers. 


e Docker Hub - This is the registry which is used to host various Docker images. 


e Docker Compose - This is used to define applications using multiple Docker 
containers. 


We will discuss all these components in detail in the subsequent chapters. 


The official site for Docker is https://www.docker.com/ The site has all information and 
documentation about the Docker software. It also has the download links for various 
operating systems. 
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2. Docker- Installing Docker on Linux 


To start the installation of Docker, we are going to use an Ubuntu instance. You can use 
Oracle Virtual Box to setup a virtual Linux instance, in case you don’t have it already. 


The following screenshot shows a simple Ubuntu server which has been installed on Oracle 
Virtual Box. There is an OS user named demo which has been defined on the system 
having entire root access to the sever. 


lemo@Cubuntu :~ 


To install Docker, we need to follow the steps given below. 


Step 1: Before installing Docker, you first have to ensure that you have the right Linux 
kernel version running. Docker is only designed to run on Linux kernel version 3.8 and 
higher. We can do this by running the following command: 


uname 


This method returns the system information about the Linux system. 


Syntax 


uname -a 


Options 


a - This is used to ensure that the system information is returned. 


Return Value 


This method returns the following information on the Linux system: 


e kernel name 

e node name 

e kernel release 

e kernel version 

e machine 

e processor 

e hardware platform 


e operating system 


Example 
uname -a 
3 
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Output 
When we run above command, we will get the following result: 


emoBgubuntu:^"$ uname -a 
Linux ubuntu 4.2.0-27-generic 1432 14.04.1-Ubuntu SMP Fri Jan 22 15:32:27 UTC 201 
1686 i686 i686 GNU/Linux 


emoBubuntu:^$ _ 


From the output, we can see that the Linux kernel version is 4.2.0-27 which is higher than 
version 3.8, so we are good to go. 


Step 2: You need to update the OS with the latest packages, which can be done via the 
following command: 


apt-get 


This method installs packages from the Internet on to the Linux system. 


Syntax 


sudo apt-get update 


Options 
e sudo - The sudo command is used to ensure that the command runs with root 
access. 


e update - The update option is used ensure that all packages are updated on the 
Linux system. 


Return Value 


None 


Example 


sudo apt-get update 
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Output 
When we run the above command, we will get the following result: 


http://us.archive.ubuntu.com trusty-backports/universe Sources 
http://us.archive.ubuntu.com trusty—backports/multiverse Sources 
http://us.archive.ubuntu.com trusty-backports/main i386 Packages 
http://us.archive.ubuntu.com trusty-backports/restricted i386 Packages 
http://us.archive.ubuntu.com trusty-backports/universe i386 Packages 
http://us.archive.ubuntu.com trusty-backports/multiverse i386 Packages 
http://us.archive.ubuntu.com trusty-backports/main Translation-en 
http://us.archive.ubuntu.com trusty-backports/multiverse Translation-en 
http://us .archive.ubuntu.com trusty-backports/restricted Translation-en 
http://us.archive.ubuntu.com trusty-backports/universe Translation-en 
http://us.archive.ubuntu.com trusty Release 
http://us.archive.ubuntu.com trusty/main Sources 
http://us.archive.ubuntu.com trusty/restricted Sources 
http://us.archive.ubuntu.com trusty/universe Sources 
http://us.archive.ubuntu.com trusty/multiverse Sources 
http://us.archive.ubuntu.com trusty/main i386 Packages 
http://us.archive.ubuntu.com trusty/restricted i386 Packages 
http://us.archive.ubuntu.com trusty/universe i386 Packages 
http://us.archive.ubuntu.com trusty/multiverse i386 Packages 
http://us.archive.ubuntu.com trusty/main Translation-en 
http://us.archive.ubuntu.com trusty/multiverse Translation-en 
http://us.archive.ubuntu.com trusty/restricted Translation-en 
http://us.archive.ubuntu.com trusty/universe Translation-en 
http://us.archive.ubuntu.com trusty/main Translation-en US 
http://us.archive.ubuntu.com trusty/multiverse Translation-en US 
http://us.archive.ubuntu.com trusty/restricted Translation-en US 
http://us.archive.ubuntu.com trusty/universe Translation-en US 
kB in 21s (184 kBvs) 
eading package lists... Done 
enoBubuntu : ^S 


This command will connect to the internet and download the latest system packages for 
Ubuntu. 


Step 3: The next step is to install the necessary certificates that will be required to work 
with the Docker site later on to download the necessary Docker packages. It can be done 
with the following command: 


sudo apt-get install apt-transport-https ca-certificates 
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emoBubuntudemo:^S sudo apt-get install apt-transport-https ca-certificates 
. Done 


. Done 
The following packages will be upgraded: 
apt-transport-https ca-certificates 
2 upgraded, 0 newly installed, 0 to remove and 105 not upgraded. 
eed to get 215 kB of archives. 
After this operation, 8,192 B disk space will be freed. 
Get:1 http:/vus.archive.ubuntu.com/ubuntuy trusty-updates/main apt-transport-ht 
ps amd64 1.0.1ubuntu2.15 [25.0 kB] 
3et:2 http:/vus.archive.ubuntu.com/ubuntuy trusty-updates/main ca-certificates 
11 20160104ubuntu0.14.04.1 [190 kB] 
Fetched 215 kB in is (152 kB^s) 
reconfiguring packages ... 
(Reading database ... 57694 files and directories currently installed.) 
reparing to unpack .../apt-transport-https 1.0.1ubuntuZ2.15 amd64.deb . 
npacking apt-transport-https (1.0.1ubuntu2.15) over (1.0.1ubuntu2.11) ... 
reparing to unpack ...^/ca-certificates 20160104ubuntu0.14.04.1 all.deb ... 
npacking ca-certificates (20160104ubuntu0.14.04.1) over (20141019ubuntu0 .14 .04 
pe 


pdating certificates in /etc/ssl/certs... 19 added, 19 removed; done. 
unning hooks in /etc/ca-certificates/update.d....done. 
emo@ubuntudemo :~§ 


Step 4: The next step is to add the new GPG key. This key is required to ensure that all 
data is encrypted when downloading the necessary packages for Docker. 


The following command will download the key with the ID 
58118E89F3A912897C070ADBF76221572C52609D from the keyserver 
hkp://ha.pool.sks-keyservers.net:80 and adds it to the adv keychain. Please note that 
this particular key is required to download the necessary Docker packages. 


sudo apt-key adv \ 
--keyserver hkp://ha.pool.sks-keyservers.net:80 \ 
--recv-keys 58118E89F3A912897C070ADBF76221572C52609D 


emoBubuntudemo:^S sudo apt-key adu N —-keyserver hkp:^/^/ha.pool.sks-keyservers. 

et:80 \ ——recu-keus 58118E89F36912897C0706DBF?6221572C52609D 

Executing: gpg --ignore-time-conflict --no-options --no-default-keyring --home 
/]imp^tmp.KcaZ3UlmGt —-no-auto-check-trustdb --trust-model always --keuyring 76 
/apt/trusted.gpg --primary-keyring /etc/apt/trusted.gpg  --keuserver hkp://ha. 

ool.sks-keyseruers.net:80 --recu-keys 58118E89F36912897C0?06nDBF?6221572C52609D 

gpg: requesting key 2C52609D from hkp server ha.pool.sks—keyservers.net 


gpg: key 2C52609D: public key “Docker Release Tool (releasedocker) <docker@dock 
.com»" imported 

gpg: Total number processed: 1 

gpg: imported: 1 CRSA: 1) 
emo@ubuntudemo :^$ 
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Step 5: Next, depending on the version of Ubuntu you have, you will need to add the 
relevant site to the docker.list for the apt package manager, so that it will be able to 
detect the Docker packages from the Docker site and download them accordingly. 


e Precise 12.04 (LTS) — deb https://apt.dockerproject.org/repo ubuntu-precise main 

e Trusty 14.04 (LTS) — deb https://apt.dockerproject.org/repo ubuntu-trusty main 

e Wily 15.10 — deb https://apt.dockerproject.org/repo ubuntu-wily main 

e Xenial 16.04 (LTS) — deb https://apt.dockerproject.org/repo ubuntu-xenial main 
Since our OS is Ubuntu 14.04, we will use the Repository name as "deb 


https://apt.dockerproject.org/repo ubuntu-trusty main" 


And then, we will need to add this repository to the docker.list as mentioned above. 


echo "deb https://apt.dockerproject.org/repo ubuntu-trusty main" | sudo tee 
/etc/apt/sources.list.d/docker.list 


emo@ubuntudemo:~$ echo "deb https://apt.dockerpro ject .org/repo ubuntu-trustu 


in" i sudo tee /etc/apt/sources. list .d/docker. list 
eb https://apt .dockerpro ject .org’repo ubuntu-trusty main 


emo@ubuntudemo:~$ _ 


Step 6: Next, we issue the apt-get update command to update the packages on the 
Ubuntu system. 


.archiue .ubuntu. trusty-backports/main Translation-en 
.archiue.ubuntu. trusty-backports/multiverse Translation-en 
.archiue ubuntu. trusty-backports/restricted Translation-en 
„archive .ubuntu. trusty-backports/universe Translation-en 
.archiue.ubuntu. trusty Release 
.archiue.ubuntu. trusty/main Sources 
.archiue.ubuntu. trusty/restricted Sources 
.archiue.ubuntu. trusty/universe Sources 
„archive .ubuntu. trusty/multiverse Sources 
„archive .ubuntu. trusty/main amd64 Packages 
„archive .ubuntu. trusty/restricted amd64 Packages 
„archive .ubuntu. trusty/universe amd64 Packages 
„archive .ubuntu. trusty/multiverse amd64 Packages 
„archive .ubuntu. trusty/main i386 Packages 
„archive .ubuntu. trustu/restricted i386 Packages 
.archiue.ubuntu. trusty/universe i386 Packages 
.archive .ubuntu. trusty/multiverse i386 Packages 
-archive.ubuntu. trusty/main Translation-en 
-archive.ubuntu. trusty/multiverse Translation-en 

http: -archive.ubuntu. trusty/restricted Translation-en 

http: .archive .ubuntu. trusty/universe Translation-en 

http: „archive ubuntu. trusty/main Translation-en US 

http: „archive ubuntu. trusty/multiverse Translation-en US 

http: .archiue.ubuntu. trusty/restricted Translation-en US 

gn http: .archiue.ubuntu.com trusty/universe Translation-en US 
Fetched 3,333 kB in 36s (90.8 kB/s) 
Reading package lists... Done 
emo@ubuntudemo : ^S 
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Step 7: If you want to verify that the package manager is pointing to the right repository, 
you can do it by issuing the apt-cache command. 


apt-cache policy docker-engine 


In the output, you will get the link to 


1.8.2-0^trustuy 9 
500 https://apt.dockerpro ject .org’repo’ ubuntu-trustu^/main 


.8.1-0^trustuy 9 
500 https:/vapt.dockerpro ject .org’repo’ ubuntu-trusty/main 


-8.0-O~trusty 9 
500 https://apt.dockerpro ject .org’repo’ ubuntu-trustu^/main 


-?.1-O" trusty O 
500 https://apt .dockerpro ject .org’repo’ ubuntu-trustu^/main 


.?.0-0"trustu O 
500 https://apt .dockerpro ject .org’repo’ ubuntu-trustu^/main 


-6.2-O" trusty 0 
500 https://apt .dockerpro ject .org’repo’ ubuntu-trusty/main 


-6.1-O”trusty O 
500 https://apt.dockerpro ject .org’repo’ ubuntu-trustu^/main 


-6.0-O~trusty 90 
500 https://apt.dockerpro ject .org’repo’ ubuntu-trustu^/main 


1.5.0-0^"trustu 9 
500 https://apt.dockerpro ject .org’repo’ ubuntu-trustu^/main 


eno@ubuntudemo :~$ 


Step 8: Issue the apt-get update command to ensure all the packages on the local 
system are up to date. 


http: -archive.ubuntu. trusty—backports/main Translation-en 
http: -archive.ubuntu. trusty—backports/multiverse Translation-en 
http: -archive.ubuntu. trusty—backportsyrestricted Translation-en 
http: -archive.ubuntu. trusty—backports/universe Translation-en 
http: .archiue.ubuntu. trusty Release 

http: .archiue.ubuntu. trusty/main Sources 

http: .archiue.ubuntu. trustu^restricted Sources 

http: -archive.ubuntu. trusty/universe Sources 

http: -archive.ubuntu. trusty/multiverse Sources 

http: .archiue.ubuntu. trusty/main amd64 Packages 

http: -archive.ubuntu. trustyvrestricted amd64 Packages 

http: .archiue.ubuntu. trusty/universe amd64 Packages 

http: -archive.ubuntu. trusty/multiverse amd64 Packages 

http: -archive.ubuntu. trusty/main i386 Packages 

http: .archiue.ubuntu. trustuy^zrestricted i386 Packages 

http: .archiue.ubuntu. trusty/universe i386 Packages 

http: -archive.ubuntu. trustuy^/multiuerse i386 Packages 

http: .archiue.ubuntu. trusty/main Translation-en 

http: -archive.ubuntu. trustuy^/multiuerse Translation-en 

http: -archive.ubuntu. trustu^/restricted Translation-en 

http: .archiue.ubuntu. trusty/universe Translation-en 

http: .archiue.ubuntu. trusty/main Translation-en US 

http: -archive.ubuntu. trusty/nultiverse Translation-en US 
http: .archiue.ubuntu. trustuy^/restricted Translation-en US 
http: -archive.ubuntu. trusty/universe Translation-en US 


Done 


emo@ubuntudemo :^$ 
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Step 9: For Ubuntu Trusty, Wily, and Xenial, we have to install the linux-image-extra-* 
kernel packages, which allows one to use the aufs storage driver. This driver is used by 
the newer versions of Docker. 


It can be done by using the following command: 


sudo apt-get install linux-image-extra-$(uname -r) linux-image-extra-virtual 


linux image: /boot/umlinuz-4.2.0-27?7-generic 
initrd image: ^/boot/initrd.img-4.2.0-27-generic 
linux image: ^/boot/umlinuz-3.13.0-105-generic 
initrd image: ^/boot/initrd.img-3.13.0-105-generic 
memtest86* image: /memtest86+.elf 

memtest86* image: /memtest86+.bin 


petting up linux-image-extra-3.13.0-105-generic (3.13.0-105.152) 
run-parts: executing /etc^/kernel^postinst.d/apt-auto-removal 3.13.0-105-generi 
boot^/umlinuz-3.13.0-105-generic 
run-parts: executing /etc^kernel/^/postinst.d/initramfs-tools 3.13.0-105-generic 
boot/umlinuz-3.13.0-105-generic 
|ipdate-initramfs: Generating /boot/initrd. img—3.13.0-105-gener ic 
run-parts: executing “etc/kernel/postinst .d/update-notifier 3.13.0-105-gener ic 
boot/umlinuz-3.13.0-105-generic 
run-parts: executing “etc/kernel/postinst .d/zz-update-grub 3.13.0-105-generic 
oot/umlinuz-3.13.0-105-generic 
senerating grub configuration file 
linux image: /boot^zumlinuz-4.2.0-27-qgeneric 
initrd image: /boot/initrd. img—4.2.0-2?-generic 
linux image: /boot/ymlinuz—3.13 .0-105-gener ic 
initrd image: /boot/initrd. img—3.13.0-105-generic 
memtest86+ image: /memtest86+.elf 
memtest86* image: /memtest86+.bin 


petting up linux-image-generic (3.13.0.105.113) ... 
petting up linux-image-extra-virtual (3.13.0.105.113) 
emo@ubuntudemo : ^S 


Step 10: The final step is to install Docker and we can do this with the following command: 


sudo apt-get install -y docker-engine 


Here, apt-get uses the install option to download the Docker-engine image from the 
Docker website and get Docker installed. 


The Docker-engine is the official package from the Docker Corporation for Ubuntu-based 
systems. 
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Selecting previously unselected package liberror-perl. 
to unpack .../liberror-perl 0.17-1.1 all.deb ... 
liberror-perl (0.17-1.1) 
previously unselected package git-man. 
to unpack .../git-man 173a1.9.1-1ubuntu0.3 all.deb ... 
git-man (1:1.9.1-1ubuntu0 .3) 
previously unselected package git. 
to unpack ...7/git 173a1.9.1-1ubuntu0.3 amd64.deb ... 
git (1:1.9.1-1ubuntu0.3) 
previously unselected package cgroup-lite. 
to unpack .../cqgroup-lite 1.9 all.deb ... 
cgroup-lite (1.9) ... 
triggers for man-db (2.6.7.1-1ubuntu1) 
triggers for ureadahead (0.100.0-16) 
uill be reprofiled on next reboot 
petting up libltdl7:amd64 (2.4.2-1.?ubuntul) ... 
petting up libsustemd- journal0:amd64 (204-5ubuntu2ZO .20) 
petting up aufs-tools (1:3.2+20130722-1.1) 
Setting up docker-engine (1.12.3-0^trustu) 
ocker start/running, process 22612 
Setting up liberror-perl (0.17-1.1) ... 
petting up git-man (1:1.9.1-1ubuntu0.3) 
petting up git (1:1.9.1-1ubuntu0 .3) 
Setting up cgroup-lite (1.9) 
group-lite start/ruming 
rocessing triggers for libc-bin (2.19-Oubuntu6.7) 
rocessing triggers for ureadahead (0.100.0-16) 
emo@ubuntudemo :~$ 


In the next section, we will see how to check for the version of Docker that was installed. 


Docker Version 


To see the version of Docker running, you can issue the following command: 


Syntax 


docker version 


Options 


e version - It is used to ensure the Docker command returns the Docker version 
installed. 


Return Value 


The output will provide the various details of the Docker version installed on the system. 


Example 


sudo docker version 
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Output 


When we run the above program, we will get the following result: 


eno@ubuntudemo:~5 sudo docker version 
lient: 

Version: 1:12: 

API version: 1.24 

Go version: go1.6.3 

Git commit: 6b644ec 

Built: Wed Oct 26 21:44:32 2016 
OS/Arch: linux/amd64 


Version: 1.12.3 

API version: 1.24 

Go version: go1.6.3 

Git commit: 6b644ec 

Built: Wed Oct 26 21:44:32 2016 
OS/Arch: linux/amd64 
emo@ubuntudemo:~5 _ 


Docker Info 


To see more information on the Docker running on the system, you can issue the following 
command: 


Syntax 


docker info 


Options 


e info - It is used to ensure that the Docker command returns the detailed 
information on the Docker service installed. 


Return Value 


The output will provide the various details of the Docker installed on the system such as 


e Number of containers 

e Number of images 

e The storage driver used by Docker 
e The root directory used by Docker 


e The execution driver used by Docker 


Example 


sudo docker info 


11 


pi tutorialspoint 


Docker 


Output 


When we run the above command, we will get the following result: 


Backing Filesystem: extfs 

Dirs: O 

Dirpermi Supported: true 
Logging Driver: json-file 

group Driver: cgroupfs 


Volume: local 
Network: bridge null host overlay 
Swarm: inactive 
> runc 
Default Runtime: runc 


https :// index .docker .io/v1i/ 
ARNING: No swap limit support 
Insecure Registries: 
127 .0.0.0/8 
emo@ubuntudemo :~$ 


Docker for Windows 


Docker has out-of-the-box support for Windows, but you need to have the following 
configuration in order to install Docker for Windows. 


System Requirements 
Windows OS Windows 10 64 bit 
Memory 2 GB RAM (recommended) 
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You can download Docker for Windows from: https://docs.docker.com/docker-for-windows/ 


« Get started with Docker X \ 


é c | â https://docs.docker.com/docker-for-windows/ 


Welcome to the Docs 


— . Get started with Docker 
ww ~ for Windows 


Docker for Mac 


Estimated reading time: 22 minutes 


Dockertor Windows Welcome to Docker for Windows! 


Getting Started Please read through these — on pe to get started. To give us 


Docker ToolBox 


Docker ToolBox has been designed for older versions of Windows, such as Windows 8.1 
and Windows 7. You need to have the following configuration in order to install Docker for 
Windows. 


System Requirements 


Windows OS Windows 7 , 8, 8.1 
Memory 2 GB RAM (recommended) 
Virtualization This should be enabled. 
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You can download Docker ToolBox from: https://www.docker.com/products/docker- 
toolbox 


y @ Docker Toolbox | Docker X \ 


e Bihttps:;//www.docker.com/products/docker-toolbox * | : 


dp docker LOG-IN SIGN-UP 


DOCKER TOOLBOX 


The Docker Toolbox is an installer to quickly and 
easily install and setup a Docker environment on 


your compute! 


| [| Download 
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3. Docker- Installation 


Let's go through the installation of each product. 


Docker for Windows 


Once the installer has been downloaded, double-click it to start the installer and then 
follow the steps given below. 


Step 1: Click on the Agreement terms and then the Install button to proceed ahead with 
the installation. 


4 Docker Setup 


DOCKER FOR WINDOWS 1.12.3 
END USER LICENSE AGREEMENT 


THIS DOCKER FOR WINDOWS END USER LICENSE 
AGREEMENT (“AGREEMENT”) IS BY AND BETWEEN 
DOCKER, INC., LOCATED AT 144 TOWNSEND 
STREET, SAN FRANCISCO, CA 94107 (“DOCKER”) 
AND YOU OR THE ENTITY ON WHOSE BEHALF YOU 
ARE ENTERING INTO THIS AGREEMENT (*YOU" OR 
“CUSTOMER”) AND GOVERNS YOUR USE OF 


FEET TIT Se Eee RA IT à 34 FC are 


[MII accept the terms in the License Agreement 
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Step 2: Once complete, click the Finish button to complete the installation. 


9 Docker Setup — x 


Completed the Docker Setup Wizard 


Click the Finish button to exit the Setup Wizard. 


Launch Docker 


Docker ToolBox 


Once the installer has been downloaded, double-click it to start the installer and then 
follow the steps given below. 


Step 1: Click the Next button on the start screen. 


E Setup - Docker Toolbox — X 


Welcome to the Docker Toolbox 
Setup Wizard 


This will install Docker Toolbox version 1.12.3 on your 
computer. 


It is recommended that you close all other applications before 
continuing. 


Click Next to continue, or Cancel to exit Setup. 


[C] Help Docker improve Toolbox. 
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Step 2: Keep the default location on the next screen and click the Next button. 


EJ Setup - Docker Toolbox = x 
Where should Docker Toolbox be installed? Ky 


I Sehr afi mtli Docker Tieclbex into Ve a felder. 


To continue, click Next. If you would like to select a different folder, click Browse. 


:Wrogram Files\Docker Toolbox 


At least 78.4 MB of free disk space is required. 


EJ Setup - Docker Toolbox 


Select Components 
Which components should be installed? 


Select the components you want to install; dear the components you do not want to 
install. Click Next when you are ready to continue. 


^| Docker Client for Windows 
^| Docker Machine for Windows 


[] Kitematic for Windows (Alpha) 
L] Git for Windows 


Current selection requires at least 339.3 MB of disk space. 
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Step 4: Keep the Additional Tasks as they are and then click the Next button. 


EJ Setup - Docker Toolbox — x 


Select Additional Tasks 
Which additional tasks should be performed? 


Select the additional tasks you would like Setup to perform while installing Docker 
Toolbox, then click Next. 


Create a desktop shortcut 

[M] Add docker binaries to PATH 

[7] Upgrade Boot2Docker VM 

L] Install VirtualBox with NDISS driver[default NDIS6] 


Step 5: On the final screen, click the Install button. 


EJ Setup - Docker Toolbox — 


Ready to Install 
Setup is now ready to begin installing Docker Toolbox on your computer. 


Click Install to continue with the installation, or dick Back if you want to review or 
change any settings. 


Destination location: 
C:\Program Files\Docker Toolbox 


Setup type: 


Kitematic for Windows (Alpha) 
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Working with Docker Toolbox 


Let's now look at how Docker Toolbox can be used to work with Docker containers on 
Windows. The first step is to launch the Docker Toolbox application for which the shortcut 
is created on the desktop when the installation of Docker toolbox is carried out. 


m cp. —— i 


Next, you will see the configuration being carried out when Docker toolbox is launched. 


Docker Quickstart Terminal — o x 


(default) Starting the WM... 
(default) Check network to re-create if eded... 
(default) Windo ght ask for the per i . a network adapter. Sometimes, such confirmatio 
n window is minimized in the taskbar. 
(default) Found a new h -only adapter: "VirtualBox Host-Only Ethernet Adapter #3” 
(default) Windows ght ask for the permission to configure a network adapter. Sometimes, such confirma 
tion window is mi ized in the taskbar. 
(default) Wind might ask for the permission to configure a dhcp server. Sometimes, such confirmation 
window is minimized in the taskbar. 
(default) Waiting for an IP... 
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Once done, you will see Docker configured and launched. You will get an interactive shell 
for Docker. 


o MINGW/64:/c/Users/s362692 a oO x 


To test that Docker runs properly, we can use the Docker run command to download and 
run a simple HelloWorld Docker container. 


The working of the Docker run command is given below: 


docker run 


This command is used to run a command in a Docker container. 


Syntax 


docker run image 


Options 


e Image - This is the name of the image which is used to run the container. 


Return Value 


The output will run the command in the desired container. 


Example 


sudo docker run hello-world 


This command will download the hello-world image, if it is not already present, and run 
the hello-world as a container. 
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Output 


When we run the above command, we will get the following result: 


MINGW64:/c/Users/s362692 — m x 


image 'he -world:late 
/hello-worl 


ce4b14da8d14: 
Di sha : 5 97€ 5 : : = 9431a1feb6efd9 


Hello from 
This 


The Do 
The Doc daemon created a new t the 
that prod U u are cu ing. 


to the Do ient, which sent it 


run an Ubun tainer with: 


and more with a free 


guide/ 


If you want to run the Ubuntu OS on Windows, you can download the Ubuntu Image using 
the following command: 


Docker run -it Ubuntu bash 


Here you are telling Docker to run the command in the interactive mode via the -it option. 


root@3bba5a5155b8: / ES O x 


Hub. 


runs the 


daemon streamed that » whic sent it 
terminal. 


something more ambitio you can run an Ubuntu container with: 
r run -it intu bash 


and more with a fr ^ Hub a 


ubuntu bash 
nage 'ubuntu: 
from libra 
Pull 
Pull 
Pull 


abef7dbdd42b € ccd6261da5d8839643 


or ubuntu 


f 
f 


@3bbaSa5155b8: 


In the output you can see that the Ubuntu image is downloaded and run and then you will 
be logged in as a root user in the Ubuntu container. 
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Docker Hub is a registry service on the cloud that allows you to download Docker images 
that are built by other communities. You can also upload your own Docker built images to 
Docker hub. In this chapter, we will see how to download and the use the Jenkins Docker 
image from Docker hub. 


The official site for Docker hub is: 


Step 1: First you need to do a simple sign-up on Docker hub. 


- oF X 
@ Docker Hub | Docker x 
€ 5» cial * 
1 | 
| | E 
Step 2: Once you have signed up, you will be logged into Docker Hub. 
- a x 
Docker Hub x 
Q | @ https://hub.docker.com * 


Ld Dashboard Explore Organizations Q Search Create A shakinstev 


bí & Repositories 
Private Repositories: Using 0 of 1 


Welcome to Docker Hub 


Here are a few things to get you started. 


i) Ss © 


Create Repository Create Organization Explore Repositories 
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Step 3: Next, let's browse and find the Jenkins image. 


@ library/enkinz - Docker X 
€ Q | â htpsy/hub.docker.com 


jenkins ts now available 


si 
22:z2 b> Dashboard Explore Jrganizations 


OFFICIAL REPOSITORY 


jenkins vw 


Shon Descnption 


Official Jenkins Docker image 


Full Description 


Step 4: If you scroll down on the same page, you can see the Docker pull command. This 
will be used to download the Jenkins image onto the local Ubuntu server. 


@ libeory/jenkins -Docker x 
https) /hub.docker.com 
Before you start to code. we recommend discuss ng your plans through a Gill ue. especially for more 


ambitious contnbutions. This gives other contributors a chance to posnt you in the night direction, grve you feedbac k 


on your design, and help you find out if someone else is work ng on the same thing 


Documentation 


Documentabon for this image is stored in the jenkins/ Wihe docker-library/docs 


sure to famitiarize yourself with the re README .ec file before attempting a pull request 


Docker Pull Command 
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Step 5: Now, go to the Ubuntu server and run the following command: 


sudo docker pull jenkins 


: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
5al4cBafbb3a: Pull complete 
ecO70f 7e6511e: Pull complete 
383246da862f : Pull complete 
998d1854867e: Pull complete 
igest: sha256:878e055f 96c90af 9281f d859f 7c69ac289e0178594F f 36bbb85e53b789691bec 
Status: Downloaded neuer image for jenkins: latest 
emo@ubuntuserver :~§ 
emo@ubuntuserver :~§ 


To run Jenkins, you need to run the following command: 


sudo docker run -p 8080:8080 -p 50000:50000 jenkins 


Note the following points about the above sudo command: 


e Weare using the sudo command to ensure it runs with root access. 


e Here, jenkins is the name of the image we want to download from Docker hub and 
install on our Ubuntu machine. 


e -pis used to map the port number of the internal Docker image to our main Ubuntu 
server so that we can access the container accordingly. 
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enkins initial setup is required. An admin user has been created and a password 
generated. 
Please use the following password to proceed to installation: 


69a504bd19634390b4e67f dd0a908e67 


This may also be found at: /var/ jenkins_home/secrets/ initialAdminPassword 


-> setting agent port for jnlp 

-> setting agent port for jnlp... done 
Dec 01, 2016 8:16:21 PM hudson.model .UpdateSite updateData 

INFO: Obtained the latest update center data file for UpdateSource default 
Dec 01, 2016 8:16:22 PM hudson.model.UpdateSite updateData 

INFO: Obtained the latest update center data file for UpdateSource default 
Dec 01, 2016 8:16:22 PM hudson.model.DounloadServiceSDounloadable load 
INFO: Obtained the updated data file for hudson.tasks .Maven.MavenInstaller 
Dec 01, 2016 8:16:22 PM hudson.WebAppMain$3 run 

INFO: Jenkins is fully up and running 
Dec 01, 2016 8:16:25 PM hudson.model.DounloadServiceSDownloadable load 
INFO: Obtained the updated data file for hudson.tools.JDKInstaller 
Dec 01, 2016 8:16:25 PM hudson.model .AsyncPeriodicWork$1 run 

INFO: Finished Download metadata. 18,216 ms 


You will then have Jenkins successfully running as a container on the Ubuntu machine. 
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5. Docker- Images 


In Docker, everything is based on Images. An image is a combination of a file system and 
parameters. Let's take an example of the following command in Docker. 


docker run hello-world 


e The Docker command is specific and tells the Docker program on the Operating 
System that something needs to be done. 


e The run command is used to mention that we want to create an instance of an 
image, which is then called a container. 


e Finally, "hello-world" represents the image from which the container is made. 


Now let's look at how we can use the CentOS image available in Docker Hub to run CentOS 
on our Ubuntu machine. We can do this by executing the following command on our 
Ubuntu machine: 


sudo docker run centos -it /bin/bash 


Note the following points about the above sudo command: 


e Weare using the sudo command to ensure that it runs with root access. 


e Here, centos is the name of the image we want to download from Docker Hub and 
install on our Ubuntu machine. 


e —it is used to mention that we want to run in interactive mode. 
e /bin/bash is used to run the bash shell once CentOS is up and running. 


Displaying Docker Images 


To see the list of Docker images on the system, you can issue the following command. 


docker images 


This command is used to display all the images currently installed on the system. 


Syntax 


docker images 


Options 


None 
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Return Value 


The output will provide the list of images on the system. 


Example 


sudo docker images 


Output 
When we run the above command, it will produce the following result: 


emo@ubuntuserver :~9 sudo docker images 
[sudo] password for demo: 
REPOS I TORY TAG IMAGE ID CREATED 
IRTUAL SIZE 
latest ?a86f 8f f cb25 9 days ago 


latest 99841854867e 2 weeks ago 


latest 9?cad5e16cb6 4 weeks ago 


emoBubuntuserver:^$ _ 


From the above output, you can see that the server has three images: centos, 
newcentos, and jenkins. Each image has the following attributes: 


e TAG - This is used to logically tag images. 
e Image ID - This is used to uniquely identify the image. 
e Created - The number of days since the image was created. 


e Virtual Size - The size of the image. 


Downloading Docker Images 


Images can be downloaded from Docker Hub using the Docker run command. Let's see in 
detail how we can do this. 


Syntax 


The following syntax is used to run a command in a Docker container. 


docker run image 


Options 


e Image - This is the name of the image which is used to run the container. 


Return Value 


The output will run the command in the desired container. 
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Example 


sudo docker run centos 


This command will download the centos image, if it is not already present, and run the 
OS as a container. 


Output 


When we run the above command, we will get the following result: 


emoBubuntuseruer:^"S sudo docker run centos 
nable to find image 'centos:latest' locally 
latest: Pulling from centos 


[3690474eb5b4: Pull complete 
f0819edifac: Pull complete 
Obfe84bf6d3f: Pull complete 
J?cad5bei6cb6: Pull complete 
igest: sha256:934ff 980b04db1b7484595bacOc8e6f 838e1917ad3a38f 904ece64f 70bbca040 
Status: Downloaded neuer image for centos: latest 
emoBubuntuserver:^$ _ 


You will now see the CentOS Docker image downloaded. Now, if we run the Docker images 
command to see the list of images on the system, we should be able to see the centos 
image as well. 


eno@ubuntuserver :~9 sudo docker run centos 
nable to find image 'centos:latest' locally 
latest: Pulling from centos 


[3690474eb5b4: Pull conplete 
: Pull complete 


: Pull complete 
: Pull complete 


TAG IMAGE ID CREATED 
latest 998d1854867e 2 weeks ago 


latest 97cad5e16cb6 4 weeks ago 


enogubuntuserver:^S$ 


Removing Docker Images 


The Docker images on the system can be removed via the docker rmi command. Let's 
look at this command in more detail. 


docker rmi 


This command is used to remove Docker images. 
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Syntax 


docker rmi ImageID 


Options 


e  ImagelID - This is the ID of the image which needs to be removed. 


Return Value 
The output will provide the Image ID of the deleted Image. 


Example 


sudo docker rmi 7a86f8ffcb25 


Here, 7a86f8ffcb25 is the Image ID of the newcentos image. 


Output 


When we run the above command, it will produce the following result: 


idemoBubuntuseruer:"S sudo docker rmi 7a86f8ffcb25 
Untagged: newcentos: latest 


Deleted: 7a86f8ffcb258e42c11d971a04b1145151b80122e566bc2b544f 8f c3f 94caf 1e 
demo@ubuntuserver :~§ 


Let’s see some more Docker commands on images. 


docker images -q 


This command is used to return only the Image ID’s of the images. 


Syntax 


docker images -q 


Options 


e q- It tells the Docker command to return the Image ID's only. 


Return Value 


The output will show only the Image ID’s of the images on the Docker host. 


Example 


sudo docker images -q 


Output 


When we run the above command, it will produce the following result: 
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emoBubuntuseruer:^$ sudo docker images -q 
998d1854867e 


J?cad5ei6cb6 


emoBPubuntuserver:^$ _ 


docker inspect 


This command is used see the details of an image or container. 


Syntax 


docker inspect Repository 


Options 


e Repository - This is the name of the Image. 


Return Value 


The output will show detailed information on the Image. 


Example 


sudo docker inspect jenkins 


Output 
When we run the above command, it will produce the following result: 


“Hostname”: "6b3797abie90", 

"Image": "sha256:532b1ef 702484a402708f 3b65a61e6ddf 307bbf 2f df a01be553bc6c 
7678ce6c", 

"Labels": {}, 

"Machddress": "", 

"Memory": O0, 

"MemoruSuap": 0, 

"NetvuorkDisabled": false, 

"OnBuild": C1, 

"OpenStdin": false, 

"PortSpecs": null, 

"StdinÜünce": false, 

"Tty": false, 

"User": "jenkins", 

"Uolumes": t 

"/uar/ jenkins home": 15 

m 
"MorkingDir": V” 
t, 
"Created": "2016-11-16T20:52:37.568557509Z2", 
"DockerUersion": "1.12.3", 
"Id": "998d1854867eb7873a9f 45f f 4c3ab25bcf 5378c?7f c955d344e47?cb27e5df 723" , 
"Os": "linux", 
"Parent": "983246da862f 43a96?7b36cc2f claf 580df 3f 79760df 841c1954e73253014ece"' 


"Size": 5960, 
"UirtualSize": 714121162 
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6. Docker -— Containers 


Containers are instances of Docker images that can be run using the Docker run 
command. The basic purpose of Docker is to run containers. Let's discuss how to work 
with containers. 


Running a Container 


Running of containers is managed with the Docker run command. To run a container in 
an interactive mode, first launch the Docker container. 


sudo docker run -it centos /bin/bash 


Then hit Crtl+p and you will return to your OS shell. 


deno@ubuntuserver:~§$ sudo docker run -it centos /bin/bash 
[root99f215edO0bO0d3 ^1 


You will then be running in the instance of the CentOS system on the Ubuntu server. 


Listing of Containers 


One can list all of the containers on the machine via the docker ps command. This 
command is used to return the currently running containers. 


docker ps 


Syntax 


docker ps 


Options 


None 


Return Value 


The output will show the currently running containers. 


Example 


sudo docker ps 
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Output 


When we run the above command, it will produce the following result: 


emoBubuntuseruer:^S$ sudo docker ps 
ONTAINER ID IMAGE COMMAND CREATED 


STATUS PORTS NAMES 
9f 215ed0b0d3 centos: latest "/bin^bash" About a minute ago 


Up fibout a minute cocku colden 
emo@ubuntuserver :“§ 


Let’s see some more variations of the docker ps command. 


docker ps -a 


This command is used to list all of the containers on the system. 


Syntax 


docker ps -a 


Options 


e —a - It tells the docker ps command to list all of the containers on the system. 


Return Value 


The output will show all containers. 


Example 


sudo docker ps -a 


Output 


When we run the above command, it will produce the following result: 


eno@ubuntuserver:~$ sudo docker ps -a 
ONTAINER ID IMAGE COMMAND CREATED 
STATUS PORTS 
NAMES 
9f 215ed0b0d3 centos: latest "/bin^bash" 4 ninutes ago 
Up 4 minutes 
cocky_colden 
e5a02936065a centos:latest "/bin^bash" 39 minutes ago 
Exited (0) 39 minutes ago 
ecstatic hodgkin 
Jb286dd1f 16a jenkins: latest "/bin^tini —— /usr/l 18 hours ago 
Exited (0) About an hour ago 0.0.0.0:8080-»8080/tcp, 0.0.0.0:50000-»50000 
p jollu uright 
3646aa260a2d jenkins:latest "/bin^tini —— /usr/] 9 days ago 
Exited (0) 9 days ago 0.0.0.0:8080-»8080/tcp, 0.0.0.0:50000-»50000 
p  reuerent morse 
emoBPubuntuserver:^$ _ 
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docker history 


With this command, you can see all the commands that were run with an image via a 
container. 


Syntax 


docker history ImageID 


Options 


e  ImagelID - This is the Image ID for which you want to see all the commands that 
were run against it. 


Return Value 


The output will show all the commands run against that image. 


Example 


sudo docker history centos 


The above command will show all the commands that were run against the centos image. 


Output 


When we run the above command, it will produce the following result: 


demo@ubuntuserver:~$ sudo docker images 
REPOS I TORY TAG IMAGE ID CREATED 


latest 998d1854867e 2 weeks ago 
latest 9?cad5e16cb6 4 weeks ago 


demo@ubuntuserver:~$ sudo docker history centos 
CREATED CREATED BY 


4 weeks ago “bin/sh #(nop) CMD ["/bin^bash"]1 
4 weeks ago “bin/sh #(nop) LABEL name=CentO0S 
4 weeks ago “bin/sh #(mop) ADD file:54df3580ac 


3 months ago “bin/sh #(nop) MAINTAINER https:7 


demoBubuntuserver:^$ _ 
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In this chapter, we will explore in detail what we can do with containers. 


docker top 


With this command, you can see the top processes within a container. 


Syntax 


docker top ContainerID 


Options 


e ContainerID - This is the Container ID for which you want to see the top processes. 


Return Value 


The output will show the top-level processes within a container. 


Example 


sudo docker top 9f215ed0b0d3 


The above command will show the top-level processes within a container. 


Output 


When we run the above command, it will produce the following result: 


leno@ubuntuserver:~9 sudo docker ps 
IMAGE COMMAND CREATED 
PORTS NAMES 
Df 215ed0b0d3 centos: latest “sbin/bash” 12 minutes ago 
p 12 minutes cocky_colden 
eno@ubuntuserver:~§$ sudo docker top 9f215ed0b0d3 


PPID C 

TIME CMD 

678 0 

00:00:00 /bin/bash 
enoBubuntuservuer:^$ 
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docker stop 


This command is used to stop a running container. 


Syntax 


docker stop ContainerID 


Options 


e  ContainerID - This is the Container ID which needs to be stopped. 


Return Value 
The output will give the ID of the stopped container. 


Example 


sudo docker stop 9f215ed@b@d3 


The above command will stop the Docker container 9f215ed0b0d3. 


Output 


When we run the above command, it will produce the following result: 


deno@ubuntuserver:~5 sudo docker ps 

IMAGE COMMAND CREATED 

PORTS NAMES 

centos: latest “/bin/bash"” 22 minutes ago 
Up 22 minutes cocky_colden 
demo@ubuntuserver :~§ sudo docker stop 9f215ed0b0d3 


Sf215ed0b0d3 

demo@ubuntuserver:~S sudo docker rm 9f215ed0b0d3 
Sf215ed0b0d3 

demo@ubuntuserver :~$ _ 


docker rm 


This command is used to delete a container. 


Syntax 


docker rm ContainerID 


Options 


e ContainerID - This is the Container ID which needs to be removed. 
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Return Value 


The output will give the ID of the removed container. 


Example 


sudo docker rm 9f215ed@bed3 


The above command will remove the Docker container 9f215edObOd3. 


Output 


When we run the above command, it will produce the following result: 


demo@ubuntuserver :~9 sudo docker ps 

IMAGE COMMAND CREATED 

PORTS NAMES 

centos:latest “/bin/bash" 22 minutes ago 
Up 22 minutes cocky_colden 
demo@ubuntuserver :~§ sudo docker stop 9f215ed0b0d3 


9f 215ed0b0d3 

demo@ubuntuserver:~S sudo docker rm 9f215ed0b0d3 
9f 215ed0b0d3 

demo@ubuntuserver :~5 _ 


docker stats 


This command is used to provide the statistics of a running container. 


Syntax 


docker stats ContainerID 


Options 


e ContainerID - This is the Container ID for which the stats need to be provided. 


Return Value 


The output will show the CPU and Memory utilization of the Container. 


Example 


sudo docker rm 9f215edOb0d3 


The above command will provide CPU and memory utilization of the Container 
9f215edObOd3. 
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Output 


When we run the above command, it will produce the following result: 


MEM USAGE/LIMIT MEM 7 


416 KiB/1.416 GiB 0.03% 


docker attach 


This command is used to attach to a running container. 


Syntax 


docker attach ContainerID 


Options 


e  ContainerID - This is the Container ID to which you need to attach. 


Return Value 


None 


Example 


sudo docker attach 07b0b6f434fe 


The above command will attach to the Docker container 07bOb6f434fe. 


Output 


When we run the above command, it will produce the following result: 


demoBubuntuseruer:^S sudo docker ps 

IMAGE COMMAND CREATED 

PORTS NAMES 

centos: latest "/bin^bash'" 3 minutes ato 
Up 3 minutes cocky pare 


demo@ubuntuserver :~§$ sudo docker attach O7bOb6f434fe 


[root?PO7bOb6f434fe ^1 — 
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Once you have attached to the Docker container, you can run the above command to see 
the process utilization in that Docker container. 


top - 15:24:06 up 2:06, O0 users, load average: 0.00, 0.01, 0.02 

Tasks: 2 total, 1 running, 1 sleeping, 0 stopped, 0 zombie 
pCpu(s): 0.0 us, 0.3 sy, 0.0 ni, 99.7 id, 0.0 ua, 0.0 hi, 0.0 si, 90.0 
KiB Mem : 1484856 total, 1057152 free, 52368 used, 375336 buff/cache 
KiB Swap: 1519612 total, 1519612 free, 0 used. 1403868 avail Mem 


PID USER PR NI UIRT RES SHR S ~CPU ZMEM TIME+ COMMAND 
1 root 20 © 11784 2992 26445 0.0 0.2 0:00.01 bash 
15 root 20 0 51864 3772 3272 R 0.0 0.3 0:00.00 top 


docker pause 


This command is used to pause the processes in a running container. 


Syntax 


docker pause ContainerID 


Options 


e ContainerID - This is the Container ID to which you need to pause the processes 
in the container. 


Return Value 


The ContainerID of the paused container. 


Example 


sudo docker pause 07b0b6f434fe 


The above command will pause the processes in a running container 07bOb6f434fe. 


Output 
When we run the above command, it will produce the following result: 


demo@ubuntuserver:~$ sudo docker ps 
[sudo] password for demo: 
IMAGE COMMAND CREATED 
PORTS NAMES 
centos:latest "/bin^/bash'" 18 minutes ago 
Up 18 minutes cocku pare 
demo@ubuntuserver:~§ sudo docker pause 07bO0b6f434fe 
O7bOb6f 434f e 


demoBubuntuserver:^$ sudo docker ps 

CONTAINER ID IMAGE COMMAND CREATED 

STATUS PORTS NAMES 

07b0b6f 434f e centos:latest "/bin/bash" 19 minutes ago 
Up 19 minutes (Paused) cocky_pare 
demo@ubuntuserver :~$ _ 
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docker unpause 


This command is used to unpause the processes in a running container. 


Syntax 


docker unpause ContainerID 


Options 


e ContainerID - This is the Container ID to which you need to unpause the 
processes in the container. 


Return Value 


The ContainerID of the running container. 


Example 


sudo docker unpause 07bOb6f434fe 


The above command will unpause the processes in a running container: 07bOb6f434fe 


Output 
When we run the above command, it will produce the following result: 


demoBubuntuseruer:^"5S sudo docker unpause 07bOb6f434fe 
O7bOb6f 434f e 


demo@ubuntuserver : “5 


docker kill 


This command is used to kill the processes in a running container. 


Syntax 


docker kill ContainerID 


Options 


e  ContainerID - This is the Container ID to which you need to kill the processes in 
the container. 


Return Value 


The ContainerID of the running container. 
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Example 


sudo docker kill @7b@b6f434fe 


The above command will kill the processes in the running container 07bOb6f434fe. 


Output 


When we run the above command, it will produce the following result: 


deno@ubuntuserver:~$ sudo docker ps 
IMAGE COMMAND CREATED 
PORTS NAMES 
centos: latest "/bin^bash" 23 minutes ato 


Up 23 minutes cocky_pare 
demo@ubuntuserver:~§$ sudo docker kill 07bOb6f434fe 
O7bOb6f 434f e 

denogBubuntuserver:^$ 


Docker — Container Lifecycle 


The following illustration explains the entire lifecycle of a Docker container. 


Created 


UnPause 
a Paused 


Pause 


Restart 


Stop Kill 


Stopped 


Killed 


e Initially, the Docker container will be in the created state. 


e Then the Docker container goes into the running state when the Docker run 
command is used. 


e The Docker kill command is used to kill an existing Docker container. 


e The Docker pause command is used to pause an existing Docker container. 
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e The Docker stop command is used to pause an existing Docker container. 


e The Docker run command is used to put a container back from a stopped state to 
a running state. 
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The following image shows the standard and traditional architecture of virtualization. 


Guest OS Guest OS 


Hypervisor 


Host OS 


e The server is the physical server that is used to host multiple virtual machines. 
e The Host OS is the base machine such as Linux or Windows. 


e The Hypervisor is either VMWare or Windows Hyper V that is used to host virtual 
machines. 


e You would then install multiple operating systems as virtual machines on top of the 
existing hypervisor as Guest OS. 


e You would then host your applications on top of each Guest OS. 


The following image shows the new generation of virtualization that is enabled via Dockers. 
Let's have a look at the various layers. 


App App 


Docker Engine 


Host OS 


Server 
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e The server is the physical server that is used to host multiple virtual machines. So 
this layer remains the same. 


e The Host OS is the base machine such as Linux or Windows. So this layer remains 
the same. 


e Now comes the new generation which is the Docker engine. This is used to run the 
operating system which earlier used to be virtual machines as Docker containers. 


e All of the Apps now run as Docker containers. 


The clear advantage in this architecture is that you don't need to have extra hardware for 
Guest OS. Everything works as Docker containers. 


43 


f >tutorialspoint 


YEABYLEAR 


The good thing about the Docker engine is that it is designed to work on various operating 
systems. We have already seen the installation on Windows and seen all the Docker 
commands on Linux systems. Now let's see the various Docker commands on the Windows 
OS. 


Docker Images 


Let's run the Docker images command on the Windows host. 


MINGWÉA-/c/Usen/1362 - | 


From here, we can see that we have two images: ubuntu and hello-world. 


Running a Container 


Now let's run a container in the Windows Docker host. 
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We can see that by running the container, we can now run the Ubuntu container on a 
Windows host. 


Listing All Containers 


Let's list all the containers on the Windows host. 


© witiGWok/coUsen/s36268 - g 
t T 3 


Stopping a Container 


Let's now stop a running container on the Windows host. 


| @ maws Users /9362693 = 4 


So you can see that the Docker engine is pretty consistent when it comes to different 
Docker hosts and it works on Windows in the same way it works on Linux. 


45 


pi tutorialspoint 


10. Docker — Configuring Docker 


In this chapter, we will look at the different options to configure Docker. 


service docker stop 


This command is used to stop the Docker daemon process. 


Syntax 


service docker stop 


Options 


None 


Return Value 


A message showing that the Docker process has stopped. 


Example 


sudo service docker stop 


Output 
When we run the above command, it will produce the following result: 
Memo@ubuntuserver :~§$ sudo service docker stop 


[sudo] password for demo: 
docker stop/waiting 


demo@ubuntuserver :~§ 


service docker start 


This command is used to start the Docker daemon process. 


Syntax 


service docker start 


Options 


None 
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Return Value 


A message showing that the Docker process has started. 


Example 


sudo service docker start 


Output 


When we run the above command, it will produce the following result: 


demo@ubuntuserver:~9 sudo service docker stop 
[sudo] password for demo: 

docker stop/waiting 

demo@ubuntuserver:~5 sudo service docker start 


docker start/running, process 1942 
denogubuntuserver:^$ ^ 
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By default, when you launch a container, you will also use a shell command while 
launching the container as shown below. This is what we have seen in the earlier chapters 
when we were working with containers. 


deno@ubuntuserver:~§ sudo docker run -it centos /bin/bash 
[rooted76d00fbce4c ^18 demo?ubuntuserver:^$ 

eno@ubuntuserver:~§ sudo docker ps 

CONTAINER ID IMAGE COMMAND CREATED 


STATUS PORTS NAMES 
76d00f bce4c centos: latest "/bin^bash" ? seconds ago 
Jp 6 seconds boring goldstine 


eno@ubuntuserver :~$ 


In the above screenshot, you can observe that we have issued the following command: 


sudo docker run -it centos /bin/bash 


We used this command to create a new container and then used the Ctrl+P+Q command 
to exit out of the container. It ensures that the container still exists even after we exit 
from the container. 


We can verify that the container still exists with the Docker ps command. If we had to exit 
out of the container directly, then the container itself would be destroyed. 


Now there is an easier way to attach to containers and exit them cleanly without the need 
of destroying them. One way of achieving this is by using the nsenter command. 


Before we run the nsenter command, you need to first install the nsenter image. It can 
be done by using the following command: 


docker run --rm -v /usr/local/bin:/target jpetazzo/nsenter 


?8Bddc5c3Z2d95: Pull complete 
if 66065041029: Pull complete 
162610b57d94: Pull complete 
b7593cf24c20: Pull complete 
OcbZfb84d9656: Pull complete 
"Jó2Zbdd62dfa: Pull complete 
c5370c1cb31: Pull complete 
5e3c4cd314f8: Pull complete 
'3e4e1652690: Pull complete 
29c0847bbd97: Pull complete 
5cc9b463abfd: Pull complete 
fJ6b6bd8d430O5: Pull complete 
3731cc001b90: Pull complete 
?b05e8e06727?7: Pull complete 
1a0a7e2eacbe: Pull complete 
1249cf 324221: Pull complete 
Digest: shaZ56:17d4c70210e269e7642f 99c575bc9788ba9565aa9cb7?0b7132f 895a6e846d b86 
Status: Downloaded newer image for jpetazzo/nsenter: latest 
Installing nsenter to target 
Installing docker-enter to /target 
Installing importenu to /target 
lemo@ubuntudemo: “S$ 


lemo@ubuntudemo :^$ 


< > 


lian] ee c = iu (10) GSS [49] Right Ctrl 
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Before we use the nsenter command, we need to get the Process ID of the container, 
because this is required by the nsenter command. We can get the Process ID via the 
Docker inspect command and filtering it via the Pid 


root@ubuntudemo:~# sudo docker ps 
CONTAINER ID IMAGE COMMAND CREATED 


STATUS PORTS NAMES 
ef 42a4c5e663 centos:latest “/bin/bash" 2 minutes ago 
Up Z minutes stoic banach 


root@ubuntudemo:~# sudo docker inspect ef4Za4c5e663 i grep Pid 


o Mode": "", 
k ": 2978, 
root@ubuntudemo:"# — 


As seen in the above screenshot, we have first used the docker ps command to see the 
running containers. We can see that there is one running container with the ID of 
ef42a4c5e663. 


We then use the Docker inspect command to inspect the configuration of this container 
and then use the grep command to just filter the Process ID. And from the output, we 
can see that the Process ID is 2978. 


Now that we have the process ID, we can proceed forward and use the nsenter command 
to attach to the Docker container. 


nsenter 


This method allows one to attach to a container without exiting the container. 


Syntax 


nsenter -m -u -n -p -i -t containerID command 


Options 
e -uis used to mention the Uts namespace 
e -mis used to mention the mount namespace 
e -nis used to mention the network namespace 
e -pis used to mention the process namespace 
e -iisto make the container run in interactive mode. 
e -tis used to connect the I/O streams of the container to the host OS. 
e  containerID - This is the ID of the container. 


e Command - This is the command to run within the container. 


Return Value 


None 
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Example 


sudo nsenter -m -u -n -p -i -t 2978 /bin/bash 


Output 


“oot@ubuntudemo:~# sudo nsenter -m -u -n -p -i -t 2978 /bin/bash 
bash-4.2# exit 

xit 

oot@ubuntudemo:~# sudo docker ps 

ONTAINER ID IMAGE COMMAND CREATED 


PORTS NAMES 
ef 42a4c5e663 centos:latest "/bin^bash'" 9 ninutes ago 
p 9 ninutes stoic banach 
ootPubuntudemo:^H — 


From the output, we can observe the following points: 


e The prompt changes to the bash shell directly when we issue the nsenter 
command. 


e We then issue the exit command. Now normally if you did not use the nsenter 
command, the container would be destroyed. But you would notice that when we 
run the nsenter command, the container is still up and running. 
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In the earlier chapters, we have seen the various Image files such as Centos which get 
downloaded from Docker hub from which you can spin up containers. An example is again 
shown below. 


IMAGE ID CREATED 


latest 97cad5e16cb6 4 weeks ago 


jpetazzo/nsenter latest a249cf 324221 4 months ago 
70.9 MB 
root@ubuntudemo:"# — 


If we use the Docker images command, we can see the existing images in our system. 
From the above screenshot, we can see that there are two images: centos and nsenter. 


But Docker also gives you the capability to create your own Docker images, and it can be 
done with the help of Docker Files. A Docker File is a simple text file with instructions on 
how to build your images. 


The following steps explain how you should go about creating a Docker File. 


Step 1: Create a file called Docker File and edit it using vim. Please note that the name 
of the file has to be "Dockerfile" with "D" as capital. 


root@ubuntudemo:~# sudo vim Dockerfile 


Step 2: Build your Docker File using the following instructions: 


#This is a sample Image 
FROM ubuntu 


MAINTAINER demousr@gmail.com 


RUN apt-get update 
RUN apt-get install -y nginx 


CMD [“echo”,”Image created” ] 


The following points need to be noted about the above file: 


e The first line "#This is a sample Image" is a comment. You can add comments to 
the Docker File with the help of the # command. 


e The next line has to start with the FROM keyword. It tells docker, from which base 
image you want to base your image from. In our example, we are creating an 


image from the ubuntu image. 
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e The next command is the person who is going to maintain this image. Here you 
specify the MAINTAINER keyword and just mention the email ID. 


e The RUN command is used to run instructions against the image. In our case, we 
first update our Ubuntu system and then install the nginx server on our ubuntu 
image. 


e The last command is used to display a message to the user. 


Step 3: Save the file. In the next chapter, we will discuss how to build the image. 


FROM ubuntu 

MAINTAINER demousr@gmail.com 

RUN apt-get update 

RUN apt-get install -y nginx 
] 


CMD [ , 
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13. Docker - Building Docker Files 


We created our Docker File in the last chapter. It's now time to build the Docker File. The 
Docker File can be built with the following command: 


docker build 


Let's learn more about this command. 


docker build 


This method allows the users to build their own Docker images. 


Syntax 


docker build -t ImageName:TagName dir 


Options 
e -tisto mention a tag to the image 
e ImageName - This is the name you want to give to your image 
e TagName - This is the tag you want to give to your image 
e Dir - The directory where the Docker File is present. 


Return Value 


None 


Example 


sudo docker build -t myimage:0.1 . 


Here, myimage is the name we are giving to the Image and 0.1 is the tag number we 
are giving to our image. 


Since the Docker File is in the present working directory, we used "." at the end of the 
command to signify the present working directory. 
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Output 


From the output, you will first see that the Ubuntu Image will be downloaded from Docker 
Hub, because there is no image available locally on the machine. 


root@ubuntudemo:~# sudo docker build -t myimage:0.1 
Sending build context to Docker daemon 11.78 kB 
Sending build context to Docker daemon 

Step 0 : FROM ubuntu 

latest: Pulling from ubuntu 


14330285ec99: Downloading 2.535 MB/50.1 MB 
497dd7934d13: Download complete 

bca38844f 775: Download complete 
711979f32e2: Download complete 

f 38e3caZb?3a: Download complete 
1034358b91a9: Download complete 


Finally, when the build is complete, all the necessary commands would have run on the 
image. 


: unable to initialize frontend: Readline 
(Can’t locate Term/ReadLine.pm in @INC (you may need to install the T 
::ReadLine module) (@INC contains: /etc/perl /usr/local/1ib/x86_64-1 inux-—gnu/ 
n1/5.22.1 /usr/local/share/per1/5.22.1 /usr/1lib/x86_64-linux-gnu/per15/5.22 /u 
share/perl5 /usr/1ib/x86_64-linux-gnu/per1/5.22 /usr/share/per1/5.22 /usr/loc 
lib/site_perl /usr/1ib/x86_64-linux-gnu/perl-base .) at /usr/share/per15/Debcs 
if /FrontEnd/Readline.pm line 7.) 
ebconf: falling back to frontend: Teletype 
Setting up nginx-core (1.10.0-0ubuntu0.16.04.4) 
invoke-rc.d: could not determine current runlevel 
invoke-rc.d: policy-rc.d denied execution of start. 


Setting up nginx (1.10.0-0ubuntu0.16.04.4) ... 
rocessing triggers for libc-bin (2.23-Oubuntu4) 
rocessing triggers for sgml-base (1.26*nmu4ubuntu1) 
rocessing triggers for systemd (229-4ubuntu12) 

-——-» e124d8a46ac3 


: CMD echo Image created 
---» Running in 445fbe32a3ac 
-——-» 8f7e840e40?c 
Removing intermediate container 445fbe32a3ac 
Successfully built 8f7e840e40?c 


oot@ubuntudeno :~# 
< > 


BOF GOS BS G (9 (€) Rieht ctr 
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You will then see the successfully built message and the ID of the new Image. When you 
run the Docker images command, you would then be able to see your new image. 


root@ubuntudemo:~# sudo docker images 
REPOS I TORY TAG IMAGE ID CREATED 
VIRTUAL SIZE 


0.1 8f7e840e407c About a minute ago 


latest 103d358b91a9 6 days ago 
128.2 MB 
centos latest 97cad5e16cb6 4 weeks ago 
196.5 MB 
jpetazzo/nsenter latest a249cf 324221 4 months ago 
370.9 MB 
root@ubuntudeno : ^1 


You can now build containers from your new Image. 
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Public repositories can be used to host Docker images which can be used by everyone 
else. An example is the images which are available in Docker Hub. Most of the images 
such as Centos, Ubuntu, and Jenkins are all publicly available for all. We can also make 
our images available by publishing it to the public repository on Docker Hub. 


For our example, we will use the myimage repository built in the "Building Docker Files" 
chapter and upload that image to Docker Hub. Let's first review the images on our Docker 
host to see what we can push to the Docker registry. 


€ 


enoBubuntudemo:^ S sudo docker images 
REPOS I TORY TAG IMAGE ID CREATED 


8.1 7738aa0e1b36 9 ninutes ago 
latest 67591570dd29 2 days ago 
latest 104bec311bcd Z days ago 


emo@ubuntudemo:~$ _ 


Here, we have our myimage:0.1 image which was created as a part of the “Building 
Docker Files" chapter. Let's use this to upload to the Docker public repository. 


The following steps explain how you can upload an image to public repository. 


Step 1: Log into Docker Hub and create your repository. This is the repository where your 
image will be stored. Go to https://hub.docker.com/ and log in with your credentials. 


Docker Hub x 


€ C | @ hittps://hub.docker.com x 


PI. Dashboard Explore Organizations Q Search Create v — Lud v 


& Repositories 3 S Using 0 of 1 


Welcome to Docker Hub 


Here are a few things to get you started 


sh 
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Step 2: Click the button "Create Repository" on the above screen and create a repository 
with the name demorep. Make sure that the visibility of the repository is public. 


« Create Repository - Dc x 
€ Q | @ https//hub.docker.com/ad 'Osit Y 


5. Set it to be a private or public repository 


demoust - demorep| 


Visibility 


public 


Once the repository is created, make a note of the pull command which is attached to the 
repository. 


-— Im x< 
& demousr/demorep - Do: X 
€ C | à https//hub.docker.com/r/demousr/d ) ? Yr 
Full Description Ca 
Full description is empty for this repo 
Docker Pull Command is 
docker pull demousr/demorep 
Owner 
demousr 
The pull command which will be used in our repository is as follows: 
docker pull demousr/demorep 
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Step 3: Now go back to the Docker Host. Here we need to tag our myimage to the new 
repository created in Docker Hub. We can do this via the Docker tag command. 


We will learn more about this tag command later in this chapter. 


Step 4: Issue the Docker login command to login into the Docker Hub repository from the 
command prompt. The Docker login command will prompt you for the username and 
password to the Docker Hub repository. 


demoBubuntudemo:^$ sudo docker login 
Login with your Docker ID to push and pull images from Docker Hub. If you don't 
Ihave a Docker ID, head over to https://hub.docker.com to create one. 

e: demousr 


Login Succeeded 
demo@ubuntudemo :^$ 


Step 5: Once the image has been tagged, it’s now time to push the image to the Docker 
Hub repository. We can do this via the Docker push command. We will learn more about 
this command later in this chapter. 


docker tag 


This method allows one to tag an image to the relevant repository. 


Syntax 


docker tag imageID Repositoryname 


Options 
e imageID - This is the ImageID which needs to be tagged to the repository. 


e  Repositoryname - This is the repository name to which the ImageID needs to be 
tagged to. 


Return Value 


None 


Example 


sudo docker tag ab0cid3744dd demousr/demorep:1.0 
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Output 


A sample output of the above example is given below. 


demo@ubuntudemo:~$ sudo docker images 
TAG IMAGE ID CREATED 


0.1 ab0c1d3744dd 6 minutes ago 
latest 67591570dd29 2 days ago 


latest 104bec311bcd 2 days ago 


demo@ubuntudemo:~§ sudo docker tag ab0c1d3744dd demousr/demorep:1.0 
demo? ubuntudeno :^$ 


docker push 


This method allows one to push images to the Docker Hub. 


Syntax 


docker push Repositoryname 


Options 
e Repositoryname - This is the repository name which needs to be pushed to the 
Docker Hub. 


Return Value 
The long ID of the repository pushed to Docker Hub. 


Example 


sudo docker push demousr/demorep:1.0 


Output 


enoBubuntudemo:^$ sudo docker push demousr/demorep:1.0 
The push refers to a repository [docker.io/demousr/demorep]1 
fa3ddba4e69: Layer already exists 
f84b80eZ23cc: Layer already exists 
59?7Zebe5b524: Layer already exists 
3d515508d4eb: Layer already exists 
bbe6cef52379: Layer already exists 


87f 743c24123: Pushed 
32d 75bc97c41: Layer already exists 
1.0: digest: sha256:1bcdae3a9270a95798f 02cd287b91956c5a6cf 9f ae08d482eb3d11f 3a22d4 
8d42 size: 1781 
emo@ubuntudemo :^$ 


59 


Sy) >tutorialsı 


Docker 


If you go back to the Docker Hub page and go to your repository, you will see the tag 
name in the repository. 


@ demousr/demorep - Doc X 


< C | @ https://hub.docker.com/r/demousr/demorep/tags * 


=. 
sasse Dashboard Explore Organizations Q, Search Create g-- 


PUBLIC REPOSITORY 


demousr/demorep w 


Repo Info Tags Collaborators Webhooks Settings 
Tag Name Compressed Size Last Updated 
1.0 103 MB a few seconds ago 


Now let's try to pull the repository we uploaded onto our Docker host. Let's first delete the 
images, myimage:0.1 and demousr/demorep:1.0, from the local Docker host. Let's 
use the Docker pull command to pull the repository from the Docker Hub. 


demoBubuntudemo:^$ sudo docker images 
TAG IMAGE ID CREATED 


latest 67591570dd23 2 days ago 
latest 104bec311bcd Z days ago 


demo@ubuntudemo:~§$ sudo docker pull demousr/demorep:1.0 
1.0: Pulling from demousr/demorep 


b3eíic?25a85f: Already exists 
: Already exists 
: Already exists 
: Already exists 
: Already exists 
: Pull complete 
: Pull complete 
: sha256:1bcdae3a9270a95798f 02cd287b91956c5a6cf 9f ae08482eb3d11f 3a2Z2d48d42 
: Downloaded neuer image for demousr/demorep:1.0 
demo@ubuntudemo :^$ 


From the above screenshot, you can see that the Docker pull command has taken our 
new repository from the Docker Hub and placed it on our machine. 
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In Docker, the containers themselves can have applications running on ports. When you 
run a container, if you want to access the application in the container via a port number, 
you need to map the port number of the container to the port number of the Docker host. 
Let's look at an example of how this can be achieved. 


In our example, we are going to download the Jenkins container from Docker Hub. We are 
then going to map the Jenkins port number to the port number on the Docker host. 


Step 1: First, you need to do a simple sign-up on Docker Hub. 


- O X 
& Docker Hub | Docker x 
€> Cal * 
| | x 
Step 2: Once you have signed up, you will be logged into Docker Hub. 
— L1 x 
Docker Hub x 
Q | @ hitps://hub.docker.com b*4 


Ld Dashboard Explore Organizations Q Search Create 2 shakinstev 


v & Repositories 
Private Repositories: Using 0 of 1 


Welcome to Docker Hub 


Here are a few things to get you started 


a. 8 
& uw © 
Create Repository Create Organization Explore Repositories 
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Step 3: Next, let's browse and find the Jenkins image. 


@ library/jenkinz -Docker X 


Organizations 


OFFICIAL REPOSITORY 


jenkins vw 


Short Description 


Official! Jenkins Docker imagi 


Full Description - 


Step 4: If you scroll down on the same page, you can see the Docker pull command. This 
will be used to download the Jenkins Image onto the local Ubuntu server. 


EX 


= oO x 
@ libeory/jenkins -Docker X 
€ Q |â nups//hub.docker.com/ je " 
a 
Before you start to code. we recommend discussing your plans through à i a, especially for more 


ambitious contnbutions. This gives other contributors a chance to point you in the right direction, give you feedback 


on your design, and help you find out if someone else is working on the same thing 


Documentation 


Documentabon for this image is stored in the jenkins/ + f the docker-library/docs b re Be 
Sure to famitiarize yourself with the ropa README .ed [le before attempting a pull request 
Docker Pull Command r. 


docker pull jenkins 


Comments (96) 5 
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Step 5: Now go to the Ubuntu server and run the command: 


sudo docker pull jenkins 


: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
ecO70f 7e6511e: Pull complete 
983246da862f : Pull complete 
998d1854867e: Pull complete 
igest: sha256:878e055f 96c90af 9281f 4859f 7c69ac28960178594f f 36bbb85e53b789691bec 
Status: Downloaded newer image for jenkins: latest 
eno@ubuntuserver :~§ 
emo@ubuntuserver :~§ 


Step 6: To understand what ports are exposed by the container, you should use the 
Docker inspect command to inspect the image. 


Let’s now learn more about this inspect command. 


docker inspect 


This method allows one to return low-level information on the container or image. 


Syntax 


docker inspect Container/Image 


Options 


e Container/Image - The container or image to inspect. 
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Return Value 


The low-level information of the image or container in JSON format. 


Example 


sudo docker inspect jenkins 


"Id": "sha256:ff6f0851ef574309ccd37c29e024f 4d42a475d2436c8ebf a1180d45d8eb 
2901427, 
"RepoTags": I 
"jenkins: latest" 


j pe 
"RepoDigests": I 
" jenkinsesha256 :8d439e83e2e97f 4f 5f 1f f 6980f 9bda?7f 7b3e7f bá9208d94b3774d4 
5a7e3054a5b" 
J; 
"Parent": "", 
"Comment": "", 
"Created": "2016-12-01T20:17:24.2325323332Z" , 
"Container": "34804931e11a954004d6c40263174f 32d498f d3f f f f 160f 60e6ae807a323 
I365c76" , 
"ContainerConfiq": t 
“Hostname”: "6b3797abí1e90", 
“Domainname”: "", 
"User": "jenkins", 
"AttachStdin": false, 
"AttachStdout": false, 
"AttachStderr": false, 
"ExposedPorts": t 
"500007tcp": t7, 
"80807tcp": €? 
X, 
"Ttu": false, 
"OpenStdin": false, 
—-More--(C147) 


The output of the inspect command gives a JSON output. If we observe the output, we 
can see that there is a section of "ExposedPorts" and see that there are two ports 
mentioned. One is the data port of 8080 and the other is the control port of 50000. 


To run Jenkins and map the ports, you need to change the Docker run command and add 
the 'p' option which specifies the port mapping. So, you need to run the following 
command: 


sudo docker run -p 8080:8080 -p 50000:50000 jenkins 


The left-hand side of the port number mapping is the Docker host port to map to and the 
right-hand side is the Docker container port number. 
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When you open the browser and navigate to the Docker host on port 8080, you will see 
Jenkins up and running. 


BH- o x) 
| / £d Jenkins Uenkins] x NB | 


€ > CŒ |O 192.168.1.20:8080/login?from=%2F *i 


Getting Started 


Unlock Jenkins 


To ensure Jenkins is securely set up by the administrator, a password 
has been written to the log (not sure where to find it?) and this file on the 
server: 


/var/jenkins_home/secrets/initialAdminPassword 


Please copy the password from either location and paste it below. 


Administrator password 


Continue 
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You might have the need to have your own private repositories. You may not want to host 
the repositories on Docker Hub. For this, there is a repository container itself from Docker. 
Let's see how we can download and use the container for registry. 


Step 1: Use the Docker run command to download the private registry. This can be done 
using the following command: 


sudo docker run -d -p 5000:5000 --name registry registry:2 


The following points need to be noted about the above command: 


e Registry is the container managed by Docker which can be used to host private 
repositories. 


e The port number exposed by the container is 5000. Hence with the -p command, 
we are mapping the same port number to the 5000 port number on our localhost. 


e We are just tagging the registry container as "2", to differentiate it on the Docker 
host. 


e The -d option is used to run the container in detached mode. This is so that the 
container can run in the background. 


emo@ubuntudemo:~$ sudo docker run -d -p 5000:5000 --name registry registry:2 
nable to find image 'registry:2’ locally 
: Pulling from library/registry 


3690ec4760f9: Already exists 
30045f 1e8fb: Already exists 
feeaa90cbdbc: Already exists 


1f85310d350: Already exists 

b6082c239858: Already exists 

igest: sha256:1152291c?f93a4eaZddc95e46d142c31e743b6dd70e194af 9e6ebe530f 782c17 
Status: Downloaded newer image for registry:2 

bf 47ab9f 4696374648686994339a6a"?f c33b4ac889c8f 92f f e392cdf a8414068 
eno@ubuntudemo :^$ 
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Step 2: Let's do a docker ps to see that the registry container is indeed running. 


eno|ubuntudemo:^$ sudo docker run -d -p 5000:5000 --name registry registry:2 
nable to find image ‘'registry:2’ locally 
: Pulling from library/registry 


: Already exists 

: filready exists 

feeaa90cbdbc: Already exists 

61f85310d350: Already exists 

b6082c239858: Already exists 
igest: sha256:1152291c?f93a4eaZ2ddc95e46d142c31e743b6dd70e194af 9e6ebe530f 782c17 


Status: Downloaded newer image for registry:2 
bf 47ab9f 46963746d8686994339aba7f c33b4ac889c8f 92f f e392cdf a8414068 
emo@ubuntudemo:~§ sudo docker ps 
CONTAINER ID IMAGE COMMAND CREATED 
STATUS PORTS NAMES 
bf 47ab9f 4696 registry:2 “ventrypoint.sh /etc/" About a minute 
go Up About a minute 0.0.0.0:5000->5000/tcp registry 


emo@ubuntudemo:~$ _ 


We have now confirmed that the registry container is indeed running. 


Step 3: Now let’s tag one of our existing images so that we can push it to our local 
repository. In our example, since we have the centos image available locally, we are going 
to tag it to our private repository and add a tag name of centos. 


sudo docker tag 6759157@dd29 localhost:5000/centos 


The following points need to be noted about the above command: 


e 67591570dd29 refers to the Image ID for the centos image. 
e localhost:5000 is the location of our private repository. 


e Weare tagging the repository name as centos in our private repository. 


eno|ubuntudemo:^ S sudo docker images 
REPOS I TORY TAG IMAGE ID CREATED 


enousr/denorep 1.0 ab0c1d3744dd 24 hours ago 
25.3 MB 
latest 675915704429 3 days ago 
latest ff6f0851ef 57? 2 weeks ago 
2 c9bd19d022f6 8 weeks ago 


eno@ubuntudemo: 
eno@ubuntudenmo: 


sudo docker tag 67591570dd29 localhost :5000/centos 


"$ 
$ 


Step 4: Now let's use the Docker push command to push the repository to our private 
repository. 


sudo docker push localhost:5000/centos 


Here, we are pushing the centos image to the private repository hosted at 
localhost:5000. 
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eno@ubuntudenmo: 


REPOS I TORY 


enousr/demorep 
225.3 MB 


registry 


9 sudo docker images 


TAG 


1.0 


latest 


latest 


2 


IMAGE ID 


ab0c1d3744dd 


675915704429 


ff6f0851ef5? 


c9bd194022f6 


Docker 


CREATED 


24 hours ago 


3 days ago 


2 weeks ago 


8 weeks ago 


emo8ubuntudemo:^$ sudo docker tag 675915704429 localhost:5000/centos 
eno&ubuntudemo:^$ sudo docker push localhost :5000/centos 

The push refers to a repository [localhost :5000/centos 1 

34e7b85483e4: Pushed 

latest: digest: shaZ56:c577af 3197aacedf 79c5aZ04cd?f 493c8e07f f bce?f 88Bf 7600bf 19c68 
c38799 size: 529 


emo|ubuntudemo:^$ _ 


Step 5: Now let's delete the local images we have for centos using the docker rmi 
commands. We can then download the required centos image from our private repository. 


sudo docker rmi centos:latest 


sudo docker rmi 67591570dd29 


eno@ubuntudemo:~9 sudo docker images 


IREPOS I TORY 
SIZE 
enousr/demorep 
225.3 MB 


localhost :5000/centos 


TAG 


1.0 


latest 


latest 


IMAGE ID 


ab0c1d3744dd 


675915704429 


675915704429 


CREATED 
24 hours ago 
3 days ago 


3 days ago 


191.8 MB 


latest ff6f0851ef57 2 weeks ago 


2 c9bd19d022f6 6 weeks ago 
docker rmi centos: latest 


: centos: latest 
: centos8sha256:c577af 3197aacedf 79c5a204cd?f 493c8e07f f bce 7f 88f 7600bf 19c6 


localhost :5000/centos: latest 
localhost :5000/centos@sha256 :c577af 3197aacedf 79c5a204cd7f 493c8e07f f bce 


Deleted: sha256:675915704dd29de0e124ee89450458b098dbd83b12d73e5f daf 8bddcbd4ea50f 8 
Deleted: sha256:34e7b85483e48a22bd5df aZb6b9ee9565b7ef 672f 09b342409c61635f 9bca4db 


emo@ubuntudemo:~$ _ 


Step 6: Now that we don’t have any centos images on our local machine, we can now 
use the following Docker pull command to pull the centos image from our private 
repository. 


sudo docker pull localhost:5000/centos 
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Here, we are pulling the centos image to the private repository hosted at 
localhost:5000. 


eno@ubuntudemo:~9 sudo docker pull localhost :5000/centos 
sing default tag: latest 
latest: Pulling from centos 


45a2e645736c: Pull complete 
igest: sha256:c577af 3197aacedf 79c5a204cd7f 493c8e07f f bce 7f 88f 7600bf 19c688c38799 
Status: Downloaded newer image for localhost:5000/centos: latest 
emo@ubuntudemo:~§ sudo docker images 
REPOS I TORY TAG IMAGE ID CREATED 
SIZE 


enousr/denorep 1.0 ab0c1d3744dd 24 hours ago 
225.3 MB 


localhost :5000/centos latest 67591570dd29 3 days ago 
191.8 MB 
jenkins latest ff6f0851ef 57? 2 weeks ago 
714.1 MB 
Z c9bd194d022f 6 8 weeks ago 
33.3 MB 
emo@ubuntudemo :^$ 


If you now see the images on your system, you will see the centos image as well. 
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17. Docker - Building a Web Server Docker File 


We have already learnt how to use Docker File to build our own custom images. Now let's 
see how we can build a web server image which can be used to build containers. 


In our example, we are going to use the Apache Web Server on Ubuntu to build our image. 
Let's follow the steps given below, to build our web server Docker file. 


Step 1: The first step is to build our Docker File. Let's use vim and create a Docker File 
with the following information. 


FROM ubuntu 

RUN apt-get update 

RUN apt-get install -y apache2 

RUN apt-get install -y apache2-utils 
RUN apt-get clean 

EXPOSE 80 

CMD [*apache2ctl", “-D”, “FOREGROUND” ] 


The following points need to be noted about the above statements: 


e Weare first creating our image to be from the Ubuntu base image. 


e Next, we are going to use the RUN command to update all the packages on the 
Ubuntu system. 


e Next, we use the RUN command to install apache2 on our image. 


e Next, we use the RUN command to install the necessary utility apache2 packages 
on our image. 


e Next, we use the RUN command to clean any unnecessary files from the system. 


e The EXPOSE command is used to expose port 80 of Apache in the container to the 
Docker host. 


e Finally, the CMD command is used to run apache2 in the background. 


"ROM ubuntu 

AINTAINER demousr@gmail.com 

RUN apt-get update 

RUN apt-get install -y apacheZ 

RUN apt-get install -y apacheZ-utils 


RUN apt-get clean 
EXPOSE 80 
MD f'apache2ctl", "-D" , "FOREGROUND "B 


Now that the file details have been entered, just save the file. 
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Step 2: Run the Docker build command to build the Docker file. It can be done using the 
following command: 


sudo docker build -t-"mywebserver" . 


We are tagging our image as mywebserver. Once the image is built, you will get a 
successful message that the file has been built. 


rocessing triggers for libc-bin (2.23-Oubuntu5) 
rocessing triggers for systemd (229-4ubuntu12) 
rocessing triggers for sgml-base (1.26+nmu4ubuntul) 
-——-» 3deecdb58eea 


: RUN apt-get install -y apache2-utils 
---» Running in 3924b32e?2cO0 
Reading package lists... 
Building dependency tree... 
Reading state information... 
pacheZ-utils is already the newest version (2.4.18-2Zubuntu3.1). 
pacheZ-utils set to manually installed. 
0 upgraded, © newly installed, © to remove and 4 not upgraded. 
-——-» S9ddc59d17?64b 
Removing intermediate container 3924b32e7?2cO0 
: RUN apt-get clean 
---» Running in cb?3b67c8109 
===> 4a13c4c36e57 


: EXPOSE 80 
---» Running in 85245722be33 
-—-» e4d2eb0fc674 
Removing intermediate container 85245722be33 
: CMD apacheZctl -D FOREGROUND 
--—-» Running in 49d3437f799f 
-——-» 5ca8134b8487? 
Removing intermediate container 494d343?f799f 
Successfully built 5ca8134b8d87 
emo@ubuntudemo :^$ 


Step 3: Now that the web server file has been built, it'S now time to create a container 
from the image. We can do this with the Docker run command. 


sudo docker run -d -p 80:80 mywebserver 


emo@ubuntudemo:~$ sudo docker images 
TAG IMAGE ID CREATED 


ywebserver latest 5ca8134b8d87 4 minutes ago 
.6 MB 
1.0 ab0c1d3744dd 26 hours ago 
latest 104bec311bcd 3 days ago 
latest ff6f0851ef 5? 2 weeks ago 


2 c9bd194022f 6 8 ueeks ago 


eno8ubuntudemo:^S$ sudo docker run -d -p 80:80 mywebserver 
42c70f 5e90a2915d1954af 2207de75657231c906f eb9366f 15a4e5c128c0675a 
emo@ubuntudemo :^$ e 
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The following points need to be noted about the above command: 
e The port number exposed by the container is 80. Hence with the -p command, we 
are mapping the same port number to the 80 port number on our localhost. 
e The -d option is used to run the container in detached mode. This is so that the 


container can run in the background. 


If you go to port 80 of the Docker host in your web browser, you will now see that Apache 
is up and running. 


[Ì Apache2 Ubuntu Defau X 


c Q | © 192.168.137.200 & 


Apache2 Ubuntu Default Page 


cL UPUDEU — 34 


This is the default welcome page used to test the correct operation of the Apache2 server after 
installation on Ubuntu systems. It is based on the equivalent page on Debian, from which the Ubuntu 
Apache packaging is derived. If you can read this page, it means that the Apache HTTP server installed 
at this site is working properly. You should replace this file (located at /var/www/html/index.html) 
before continuing to operate your HTTP server. 

If you are a normal user of this web site and don't know what this page is about, this probably means 
that the site is currently unavailable due to maintenance. If the problem persists, please contact the 
site's administrator. 


Configuration Overview 


Ubuntu's Apache2 default configuration is different from the upstream default configuration, and split 
into several files optimized for interaction with Ubuntu tools. The configuration system is fully 
documented in /usr/share/doc/apache2/README.Debian.gz. Refer to this for the full 
documentation. Documentation for the web server itself can be found by accessing the manual if the 
apache2-doc package was installed on this server. 


The configuration layout for an Apache2 web server installation on Ubuntu systems is as follows: 


i /etc/apache2/ 


i [-- apache2.conf 

id ^-- ports.conf 

i [-- mods-enabLed i 

WI |-- *.Load 2 
iX A x = i 
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18. Docker — Instruction Commands 


Docker has a host of instruction commands. These are commands that are put in the 
Docker File. Let's look at the ones which are available. 


CMD Instruction 


This command is used to execute a command at runtime when the container is executed. 


Syntax 


CMD command parami 


Options 
e command - This is the command to run when the container is launched. 


e parami - This is the parameter entered to the command. 


Return Value 


The command will execute accordingly. 


Example 


In our example, we will enter a simple Hello World echo in our Docker File and create an 
image and launch a container from it. 


Step 1: Build the Docker File with the following commands: 


FROM ubuntu 


MAINTAINER demousr@gmail.com 


CMD [*echo" , “hello world” ] 


Here, the CMD is just used to print hello world. 


FROM ubuntu 
AINTAINER demousr@gmail.com 
MD ["echo", “hello world] 
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Step 2: Build the image using the Docker build command. 


emo8ubuntudemo:^S sudo docker build -t-'"muneudemo" . 
Sending build context to Docker daemon 21.5 kB 
Step 1 : FROM ubuntu 

-——-» 104bec311bcd 
Step 2 : MAINTAINER demousr@gmail.com 

---» Using cache 

===> 429c19673474 


Step 3 : CMD echo hello world 

---> Running in 6589f66cffd4 

-——-» 90ab8626a009 
Removing intermediate container 6589f66cffd4 
Successfully built 90ab8626a009 


emo|ubuntudemo:^$ _ 


Step 3: Run a container from the image. 


eno@ubuntudemo:~9 sudo docker run mynewdemo 


hello world 
å 


emo@ubuntudemo:"9 — 


ENTRYPOINT 


This command can also be used to execute commands at runtime for the container. But 
we can be more flexible with the ENTRYPOINT command. 


Syntax 


ENTRYPOINT command parami 


Options 
e command - This is the command to run when the container is launched. 


e parami - This is the parameter entered into the command. 


Return Value 


The command will execute accordingly. 


Example 


Let's take a look at an example to understand more about ENTRYPOINT. In our example, 
we will enter a simple echo command in our Docker File and create an image and launch 
a container from it. 


Step 1: Build the Docker File with the following commands: 


FROM ubuntu 


MAINTAINER demousr@gmail.com 


ENTRYPOINT [*echo"] 
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FROM ubuntu 
AINTAINER demousr@gmail.com 
ENTRYPOINT §echo"§ 


Step 2: Build the image using the Docker build command. 


emo8ubuntudemo:^S sudo docker build -t-"entrudemo" . 
Sending build context to Docker daemon 22.53 kB 
Step 1 : FROM ubuntu 

-——-» 104bec311bcd 
Step 2 : MAINTAINER demousr@gmail.com 

-——-» Using cache 

===> 429c19673474 
Step 3 : ENTRYPOINT echo 

---» Running in 4a06da685d12 

-——-» c26b8ef5a8c9 
Removing intermediate container 4a06da685d12 
Successfully built cZ6b8ef5a8c9 


emo@ubuntudemo :~§ 


Step 3: Run a container from the image. 


emo@ubuntudemo:~§$ sudo docker build -t="entrydemo” 
Sending build context to Docker daemon 22.53 kB 
Step 1 : FROM ubuntu 

---> 104bec311bcd 
Step 2 : MAINTAINER demousr@gmail.com 

-——-» Using cache 

===> 429c19673474 
Step 3 : ENTRYPOINT echo 


---» Running in 4a06da685d12 
-——-» c26b8ef5a8c9 


emoving intermediate container 4a06da685d12 
Successfully built cZ6b8ef5a8c9 

emo@ubuntudemo:~§ sudo docker run entrydemo Hello World 
lello World 

emo@ubuntudemo :^$ z 


ENV 


This command is used to set environment variables in the container. 


Syntax 


ENV key value 


Options 
e Key - This is the key for the environment variable. 


e value - This is the value for the environment variable. 
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Return Value 


The command will execute accordingly. 


Example 


In our example, we will enter a simple echo command in our Docker File and create an 
image and launch a container from it. 


Step 1: Build the Docker File with the following commands: 


FROM ubuntu 
MAINTAINER 


ENV vari=Tutorial var2=point 


FROM ubuntu 
AINTAINER demousr@gmail .com 
ENU vari=Tutorial var2=point_ 


Step 2: Build the image using the Docker build command. 


emo@ubuntudemo:~§$ sudo docker build -t-"enudemo" 
Sending build context to Docker daemon 23.04 kB 
Step 1 : FROM ubuntu 

-——-» 104bec311bcd 
Step 2 : MAINTAINER demousr@gmail.com 

---> Using cache 

===> 429c19673474 

3 : ENU vari Tutorial varZ point 

---» Running in 8bd8eccb5986 

-——-» 1def?e9aa854 

emoving intermediate container 8bd8eccb5986 
Successfully built 1def?e9aa854 
emo@ubuntudemo:~$ _ 


Step 3: Run a container from the image. 


emo8ubuntudemo:^S sudo docker build —t="enudemo” 
pending build context to Docker daemon 23.04 kB 
Step 1 : FROM ubuntu 

-——-» 104bec311bcd 
Step 2 : MAINTAINER demousr@gmail.com 

---> Using cache 

===> 429c19673474 


Step 3 : ENU var1 Tutorial varZ point 

---» Running in 8bd8eccb5986 

-—-5» 1def?e9aa854 

emoving intermediate container 8bd8eccb5986 
Successfully built 1def?e9aa854 

emo8ubuntudemo:^$ sudo docker run -it enudemo /bin/bash 
root? b48d9e69cc34:7t — 
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Step 4: Finally, execute the env command to see the environment variables. 


eno|ubuntudemo: S sudo docker run -it enudemo /bin/bash 
root? b48d9e69cc34:/4t env 
vari=Tutorial 
varZ-point 
10S TNAME-b484d9e69cc34 
TERM-xterm 
LS COLORS-rs-0:di-01:34:1n-01:;36:mh-00:pi-40:33:s0-01:;35:d0-01;35:bd-40:33:01:cd 
-40;33;01:0r-40;31;01:mi-00:su-37?:41:s9-30;43:ca-30;41:tu-30;42:0u-734;42:st-37?;4 
1:ex-01:32:*.tar-01;31:*.t9gz-01;31:*.arc-01;31:*.ar j-01;31:*.taz-01;31:*. 1]ha-01; 
31:*.124=01;31:*. 1lzh=01;31:*. lzma=01;31:*.t1z=01;31:*.txz=01;31:*.tzo=01;31:*.t? 
7-01:31:*.zip-01:;31:*.z-01;31:*.2-01;31:*.dz-01;31:*.9z-01;31:*.1rz-01;31:*.1z-0 
1:31:*.1zo-01;31:*.xz-01:31:*.bz2-01;31:*.bz-01:31:*.tbz-01;31:*.tbz2-01:31:*.tz 
-01:31:*.deb-01;31:*.rpm-01;31:*. jar-01:31:*.uar-01:31:*.6ear-01;31:*.sar-01;31: 
.rar-01;31:*.alz-01;31:*.ace-01;31:*.z00-01;31:*.cpio-01;31:*.7z-01;31:*.rz-01;3 
1:*.cab=01;31:*. jpg-01:35:*. jpeg=01;35:*. gif -01;35:*.bmp-01;35:*.pbm-01;35:*.pgm 
-01:35:*.ppm-01;35:*.t9ga-01;35:*.xbm-01;35:*.xpm-01;35:*.tif -01;35:*.tiff -01735: 
.png701;35:*.sug-01:35:*.sugz-01:35:*.mng-01;35:*.pcx-01;35:*.mou-01;35:*.mnpg-0 
1:35:*.npeg-01;35:*.m2Zu-01;35:*.mku-01;35:*.uebmn-01;35:*.09m-01;35:*.mp4-01;35: 
.n4u701;35:*.mp4u-01;35:*.v0b-01;35:*.q4t-01;35:*.nuv-01;35:*.umu-01:;35:*.asf -01; 
5:*.rmn-01;35:*.rmub-01;35:*.f 1c-017;35:*.avi-01;35:*.f1i-701;35:*.f 1u-01;35:*.g1- 
01:35:*.d1-01;35:*.xcf -01;35:*.xud-01;35:*.9guvu-01;35:*.cgm-01735:*.enf -01;35:*.0 
v-01:35:*.09x-01:;35:*.aac-00;36:*.au-00;36:*.f 1ac-007;36:*.m4a-00;36:*.mid-00;36 
:*,midi-00;36:*.mka-00;36:*.mp3-00;36:*.mpc-00;36:*.099700736:*.ra-00;36:*.uav-0 
0:36:*.09ga-00;36:*.0pus-00:36:*.spx-00;36:*.xspf -00:;36: 
PATH=/usr/ local/sbin:/usr/local/bin: /usr/sbin:/usr/bin:/sbin:/bin 


OME=/root 
| =/usr/bin/eny 
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WORKDIR 


This command is used to set the working directory of the container. 


Syntax 


WORKDIR dirname 


Options 
e dirname - The new working directory. If the directory does not exist, it will be 
added. 


Return Value 


The command will execute accordingly. 


Example 


In our example, we will enter a simple echo command in our Docker File and create an 
image and launch a container from it. 
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Step 1: Build the Docker File with the following commands: 


FROM ubuntu 
MAINTAINER 
WORKDIR /newtemp 
CMD pwd 


FROM ubuntu 

AINTAINER demousr@gmail.com 
ORKDIR /newtemp 

MD pud 


Step 2: Build the image using the Docker build command. 


emo@ubuntudemo:~$ sudo docker build -t-"tempdemo" . 
Sending build context to Docker daemon 23.55 kB 
Step 1 : FROM ubuntu 

-——-» 104bec311bcd 
Step 2 : MAINTAINER demousr@gmail.com 

-——-> Using cache 

===> 429019673474 
Step 3 : WORKDIR /newtemp 

-——-» Using cache 

-——-» e09e6378e765 
Step 4 : CMD pud 

---» Using cache 

——-» c?bedf4e3158 
Successfully built c?bedf4e3158 


emo@ubuntudemo :^$ 


Step 3: Run a container from the image. 


emo8ubuntudemo:^S sudo docker build -t-"tempdemo" 
Sending build context to Docker daemon 23.55 kB 
Step 1 : FROM ubuntu 

-—-» 104bec311bcd 
Step 2 : MAINTAINER demousregnmail.com 

---» Using cache 

===> 429c19673474 

Step 3 : WORKDIR /newtemp 

---> Using cache 


---> e09e6378e765 


Step 4 : CMD pud 
---> Using cache 
---> c?bedf4e3158 

Successfully built c?bedf4e3158 
eno@ubuntudemo:~9 sudo docker run tempdemo 
newtemp 
eno@ubuntudemo:~$ _ 
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Container Linking allows multiple containers to link with each other. It is a better option 
than exposing ports. Let's go step by step and learn how it works. 


Step 1: Download the Jenkins image, if it is not already present, using the Jenkins pull 
command. 


emo@ubuntudemo:~9 sudo docker jenkins pull. 


Step 2: Once the image is available, run the container, but this time, you can specify a 
name to the container by using the --name option. This will be our source container. 


emo8ubuntudemo:^$ sudo docker run --name-jenkinsa -d jenkins 


Step 3: Next, it is time to launch the destination container, but this time, we will link it 
with our source container. For our destination container, we will use the standard Ubuntu 
image. 


eno@ubuntudemo:~$ sudo docker run --name-reca --link-jenkinsa:alias-src -it ubu 


When you do a docker ps, you will see both the containers running. 
Step 4: Now, attach to the receiving container. 


eno@ubuntudemo:~9 sudo docker ps 
[sudo] password for demo: 
ONTAINER ID IMAGE COMMAND CREATED 
STATUS PORTS NAMES 
13ea6d68a149 ubuntu: latest “bin/bash” 32 minutes ago 
Up 32 minutes reca 
9f 55a4963c44 jenkins “/bin/tini —- /usr/lo 


33 minutes ago 


Up 33 minutes 8080/tcp, 50000/tcp jenkinsa 
emo@ubuntudemo:~§ sudo docker attach reca 
root? 13ea6d68a149 : 7H 
iroot?e13ea6d68a149:74 — 
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Then run the env command. You will notice new variables for linking with the source 
container. 


35 :*.rm-01;35:*.rmub-01;35:*.f 1c-01:35:*.avi-01;35:*.f1i-01;35:*.f 1v-01;35:*.g1 
01:35:*.d1-01;35:*.xcf -01:35:*.xud-01:35:*.9uv701;35:*.cgm-01;35:*.emnf -017;35:*.0 
v-01:;35:*.09x-01:;35:*.aac-00;36:*.au-700;36:*.f 1ac-00;36:*.m4a-00;36:*.mid -00;36 
:*.midi-00;36:*.mka-00;36:*.mp3-00;36:*.mpc-00;36:*.099700;36:*.ra-00;36:*.wav-0 
0:36:*.09ga-00:36:*.0pus-00:36:*.spx-00:36:*.xspf -00:36: 

aLIAS SRC PORT 50000 TCP-tcp:7/7/172.17.0.2:50000 

aLIAS SRC ENU JENKINS SLAUE AGENT PORT-50000 

aLIAS SRC PORT 8080 TCP PORT-8080 

AL IAS_SRC_ENV_JAVA_VERS ION=8u111 

PATH=/usr/ local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin 


AL IAS_SRC_ENV_LANG=C .UTF-8 
ALIAS SRC ENU JAUA DEBIAN UERSION-8u111-b14-2^bpo8*1 
aLIAS SRC PORT 50000 TCP PORT-50000 


ALIAS_SRC_PORT_8080_TCP_ADDR=172.17.0.2 

ALIAS_SRC_ENV_TINI_VERSION=0 .9.0 

AL IAS_SRC_PORT_8080_TCP_PROTO=tcp 

ALIAS_SRC_ENV_COPY REFERENCE_FILE_LOG=/var/ jenkins_home/copy_reference_f ile. log 


OME=/root 
ALIAS_SRC_PORT_50000_TCP_ADDR=172.17.0.2 
AL IAS_SRC_ENV_JENKINS_UC=https://updates. jenkins.io 
ALIAS SRC ENU TINI SHà-fa23d1e20732501c3bb8eeeca423c89ac80ed452 
AL IAS_SRC_ENV_JAVA_HOME=/usr/1lib/ jum/ java-8-open jdk-amd64 
AL IAS_SRC_ENV_JENKINS_HOME=/var7 jenkins_home 
AL IAS_SRC_PORT_8080_TCP=tcp:77172.17.0.2:8080 
=/usr/bin/eny 
root@1i3ea6d68ai149: /it 
root@13ea6d68a149: /1 
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emoBPubuntudemo:^S sudo docker ps 

[sudo] password for demo: 

CONTAINER ID IMAGE COMMAND CREATED 
STATUS PORTS NAMES 

13ea6d68a149 ubuntu: latest “sbin/bash"” 32 minutes ago 
Up 32 minutes reca 


£55a4963c44 jenkins "/bin^tini -- /usr/lo” 33 minutes ago 
Up 33 minutes 6080/tcp, 50000/tcp jenkinsa 
emo@ubuntudemo :~§ i 
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20. Docker — Docker Storage 


Storage Drivers 


Docker has multiple storage drivers that allow one to work with the underlying storage 
devices. The following table shows the different storage drivers along with the technology 


used for the storage drivers. 


Technology Storage Driver 
OverlayFS overlay or overlay2 
AUFS aufs 
Btrfs brtfs 


Device Manager 


devicemanager 


VFS 


vfs 


ZFS 


zfs 


Let us now discuss some of the instances in which you would use the various storage 


drivers: 


AUFS 


e This is a stable driver; can be used for production-ready applications. 


e It has good memory usage and is good for ensuring a smooth Docker experience 


for containers. 


e There is a high-write activity associated with this driver which should be considered. 


e It's good for systems which are of Platform as a service type work. 


Devicemapper 


e This is a stable driver; ensures a smooth Docker experience. 


e This driver is good for testing applications in the lab. 


e This driver is in line with the main Linux kernel functionality. 


Birfs 


e This driver is in line with the main Linux kernel functionality. 


e There is a high-write activity associated with this driver which should be considered. 


e This driver is good for instances where you maintain multiple build pools. 
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Ovelay 


e This is a stable driver and it is in line with the main Linux kernel functionality. 
e It has a good memory usage. 


e This driver is good for testing applications in the lab. 


e This is a stable driver and it is good for testing applications in the lab. 


e It’s good for systems which are of Platform-as-a-Service type work. 


To see the storage driver being used, issue the docker info command. 


Syntax 


docker info 


Options 


None 


Return Value 


The command will provide all relative information on the Docker component installed on 
the Docker Host. 


Example 


sudo docker info 
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Output 


The following output shows that the main driver used is the aufs driver and that the root 
directory is stored in /var/lib/docker/aufs. 


Root Dir: /var/lib/docker/aufs 
Backing Filesystem: extfs 
Dirs: 75 

Dirpermi Supported: true 
Logging Driver: json-file 
group Driver: cgroupfs 
Plugins: 

Uolume: local 

Network: bridge host overlay null 
Swarm: inactive 

: runc 


Default Runtime: runc 

Security Options: apparmor 

Kernel Version: 4.2.0-27-generic 
perating System: Ubuntu 14.04.4 LTS 


OSType: linux 

Architecture: x86_64 

PUs: 1 

Total Memory: 993.1 MiB 

ame: ubuntudemo 

ID: ECDA: IFR3:ZCQJ : FNXL:APJR: BT6Y: JJ?75: FUE6 : DNP5 : PD7B : ADAD : YUB4 
Docker Root Dir: /var/lib/docker 
Debug Mode (client): false 
Debug Mode (server): false 

sername: demousr 
Registry: https://index.docker.io/vi/ 
ARNING: No swap limit support 
Insecure Registries: 

127.0.0.0/8 
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Data Volumes 


In Docker, you have a separate volume that can shared across containers. These are 
known as data volumes. Some of the features of data volume are: 


e They are initialized when the container is created. 
e They can be shared and also reused amongst many containers. 
e Any changes to the volume itself can be made directly. 
e They exist even after the container is deleted. 
Let's look at our Jenkins container. Let's do a docker inspect to see the details of this 


image. We can issue the following command to write the output of the docker inspect 
command to a text file and then view the file accordingly. 


sudo docker inspect Jenkins » tmp.txt 


When you view the text file using the more command, you will see an entry as 
JENKINS HOME-/var/Jenkins home. 
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This is the mapping that is done within the container via the Jenkins image. 


"JRAUA DEBIAN UERSION-8u111-b14-2^ bpo8*1", 

"Ch CERTIFICATES J&UA UERSION-20140324" , 

"JENKINS HOME-/var^ jenkins. hone" , 

"JENKINS SLAUE AGENT PORT-50000", 

"TINI UERSION-0.9.0", 

"TINI. SHà-fa23d1e20732501c3bb8eeeca423c89ac80ed452" , 

"JENKINS UERSION-2.19.4", 

“ JENKINS_UC=https://updates. jenkins. io", 

"COPY REFERENCE FILE LOG-^/vuar^ jenkins  home^copu. reference file.1 


], 
“Cmd”: [ 
“bin/sh”, 
"-c", 
“t(nop) COPY file:2a6a3e16202b8dddabb5edef 50f 712c16f e8f 6980f 5aea8 
0c8c76b5db4f903913 in /usr/local/bin/install-plugins.sh " 
], 
"ArgsEscaped": true, 
“Image”: "sha256:86cb?3edf b8b3a4681961047f 1ca654c81586c748f deaf 7904e 
:bca09ae4d 720" , 
"Uolunes": t 
"/7var/jenkins home": {} 
}, 
"MorkingDir": "", 
"Entrupoint": I 
"7bin^ztini", 


u 
, 


“susr/ local/bin/ jenkins .sh" 
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Now suppose you wanted to map the volume in the container to a local volume, then you 
need to specify the -v option when launching the container. An example is shown below: 


sudo docker run -d -v /home/demo:/var/jenkins home -p 8080:8080 -p 50000:50000 
jenkins 


The -v option is used to map the volume in the container which is /var/jenkins home 
to a location on our Docker Host which is /home/demo. 


eno|ubuntudemo:^$S sudo docker run -d -u /home/demo:/var/ jenkins home -p 8080:80 
80 -p 50000:50000 jenkins 


Now if you go to the /home/demo location on your Docker Host after launching your 
container, you will see all the container files present there. 


eno&ubuntudemo:^ S pud 

hone^demo 

emo@ubuntudemo:~§ ls 

onf ig .xml jobs secrets 
copy. reference file.log logs tenp.txt 
Dockerf ile nodeMonitors .xml tmp.txt 


hudson.model.UpdateCenter .xm1 nodes userContent 
identity .key.enc plugins users 
init.groovy.d secret . key war 
jenkins.install.UpgradeMizard.state secret .key .not-so-secret 


e$ 
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Changing the Storage Driver for a Container 


If you wanted to change to the storage driver used for a container, you can do so when 
launching the container. This can be done by using the -volume-driver parameter when 
using the docker run command. An example is given below: 


sudo docker run -d -volume-driver=flocker -v /home/demo:/var/jenkins home -p 
8080:8080 -p 50000:50000 jenkins 


The -volume-driver option is used to specify another storage driver for the container. 


demo fubuntudemo:^S sudo docker run -d —-volume-driver=f locker -u /home/demo:/var 
y jenkins home -p 8080:8080 -p 50000:50000 jenkins 
Sbffbibfebee3fdi5bc58ebade534bf bf 18bf 99640052af 7190aef 5f dcf 37180 
demo@ubuntudemo :^$ 


To confirm that the driver has been changed, first let's use the docker ps command to 
see the running containers and get the container ID. So, issue the following command 
first: 


sudo docker ps 


Then issue a docker inspect against the container and put the output in a text file using 
the command. 


sudo docker inspect 9bffbibfebee > temp.txt 


demoBubuntudemo:^$ sudo docker ps 
CONTAINER ID IMAGE COMMAND CREATED 

STATUS PORTS NAME 
S 
Sbffbibfebee jenkins "/bin^tini —— /usr/lo” 2 minutes ago 


Up 2 minutes 0.0.0.0:8080-»8080/tcp, 9.0.0.0:50000->50000/tcp gloo 
mu wing 
demo@ubuntudemo:~§ sudo docker inspect 9bffbibfebee > temp.txt_ 
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If you browse through the text file and go to the line which says VolumeDriver, you will 
see that the driver name has been changed. 


"Config": £} 
H r 
"NetworkMode": "default", 
"PortBindings": t 
"590007tcp": I 
1 
"HostIp': = 
"HostPort": "50000" 
H 
l, 
"80807/tcp": I 
{ 


"Hostlp": "", 
"HostPort": "8080" 


] 
jg 
"RestartPolicu": t 
“Name”: "no", 
"MaximumRetruCount": 0 
pg 
“AutoRemove”: false, 
"UolumeDriver": "flocker", 
"UolunesFron": null, 
"Capfidd": null, 
"CapDrop": null, 
“Dns: E], 
"DnsÜüptions": [1], 
"DnsSearch": [1], 
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Creating a Volume 


A volume can be created beforehand using the docker command. Let's learn more about 
this command. 


Syntax 


docker volume create --name-volumename --opt options 


Options 


e name - This is the name of the volume which needs to be created. 
e Opt - These are options you can provide while creating the volume. 


Return Value 


The command will output the name of the volume created. 


Example 


sudo docker volume create --name=demo -opt o-size-100m 
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In the above command, we are creating a volume of size 100MB and with a name of demo. 


Output 


The output of the above command is shown below: 


demo@ubuntudemo:~9 sudo docker volume create --name-demo --opt o-size-100m 
demo 
demo8ubuntudemo:^$9 — 


e 


Listing all the Volumes 


You can also list all the docker volumes on a docker host. More details on this command 
is given below: 


Syntax 


docker volume 1s 


Options 


None 


Return Value 


The command will output all the volumes on the docker host. 


Example 


sudo docker volume 1s 


Output 

The output of the above command is shown below: 

demo@ubuntudemo:~S sudo docker volume ls 
VOLUME NAME 
0329aedc9cb821481d4a6c05619839294af 86cf ae3494a44b7aee23b1bc8 
0457e437c2496560355bb02e856d4443ec7?7e70dd6ceece12044b1cf 4d40b 
3405f ca247666c62a05ec15988534c0d 385444bc74547545?bf 108a10eb2 
3cf 320ee8bd98f 558c25af f 2803b300815da575bcc0e5a319e18316618e1 
8a32b991086de55f 3869ae1be7?057f 14dbc29c3aba70db6726a416670747? 
9c?e3f 37b4f 5483c0550f 6122b2e8f 0534025b6174aecf 14e0a12496081e 


demo 
e94311df64b?7ad609f 851c5c66d0ec04b680c83539cc272143269?f 048f b 


myvo lume 


demo@ubuntudemo :^$ 
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Docker takes care of the networking aspects so that the containers can communicate with 
other containers and also with the Docker Host. If you do an ifconfig on the Docker Host, 
you will see the Docker Ethernet adapter. This adapter is created when Docker is installed 
on the Docker Host. 


emo@ubuntudemo:~9 sudo ifconfig 

ockerO Link encap:Ethernet HWaddr 02:42:b4:a4:43:59 
inet addr:172.17.0.1 Bcast:0.0.0.0 Mask:255.255.0.0 
inet6 addr: fe80::42:b4ff :feat:4359/64 Scope:Link 
UP BROADCAST MULTICAST MTU:1500 Metric:1 
RX packets:55 errors:0 dropped:0 overruns:0 frame:0 
TX packets:28 errors:0 dropped:O overruns:O carrier:0 
collisions:0 txqueuelen:O 
RX bytes:3448 (3.4 KB) TX bytes:2576 (2.5 KB) 


Link encap:Ethernet HWaddr 08:00:27:f5:15:76 

inet addr:192.168.137.200  Bcast:192.168.137.255 Mask:255.255.255.0 
inet6 addr: fe80::a00:2?ff :fef5:1576/64 Scope:Link 

UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 

RX packets:199 errors:0 dropped:0 overruns:0 frame:0 

TX packets:70 errors:0 dropped:0 overruns:0 carrier:0 

collisions:0 txqueuelen: 1000 

RX bytes:13734 (13.7 KB) TX bytes:5238 (5.2 KB) 


Link encap:Local Loopback 

inet addr:127.0.0.1 Mask:255.0.0.0 

inet6 addr: ::17128 Scope:Host 

UP LOOPBACK RUNNING  MTU:65536 Metric:1 

RX packets:40 errors:0 dropped:0 overruns:0 frame:0 
TX packets:40 errors:0 dropped:O overruns:0 carrier:0 
collisions:0 txqueuelen:O 

RX bytes:3184 (3.1 KB) TX bytes:3184 (3.1 KB) 


eno@ubuntudeno :^$ 
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This is a bridge between the Docker Host and the Linux Host. Now let's look at some 
commands associated with networking in Docker. 


Listing All Docker Networks 


This command can be used to list all the networks associated with Docker on the host. 


Syntax 


docker network 1s 


Options 


None 
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Return Value 


The command will output all the networks on the Docker Host. 


Example 


sudo docker network 1s 


Output 
The output of the above command is shown below 


deno@ubuntudemo:~5 sudo docker network Is 

NETWORK ID NAME DRIVER SCOPE 
f O7aad6ccadf bridge bridge local 
f aae6bf679ea host host local 


54a2d37e7e00 none null local 


demo@ubuntudemo :^$ 


Inspecting a Docker network 


If you want to see more details on the network associated with Docker, you can use the 
Docker network inspect command. 


Syntax 


docker network inspect networkname 


Options 


e networkname - This is the name of the network you need to inspect. 


Return Value 


The command will output all the details about the network. 


Example 


sudo docker network inspect bridge 
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Output 
The output of the above command is shown below: 


"Name": "bridge", 
"Id": "fO7?aad6ccadf 388082ccf 9ad37db43f 78adec85f b96ae0b2e9e8390c64d674242" 


"Scope": "local", 
"Driver": "bridge", 
"EnableIPu6": false, 
“IPAM”: € 

"Driver": "default", 

“Options”: null, 

"Config": [ 

1 


“Subnet”: "172.17.0.07/16", 
“Gateway”: "172.17.0.1" 


] 
H r 
"Internal": false, 
"Containers": 17, 
“Options”: t 
" .docker .network. .default bridge": "true", 
.docker . network. .enable icc": "true", 
.docker .netuork. .enable ip masquerade": "true", 
.docker . network. -host_binding_ipv4": "0.0.0.0", 
.docker . network. name”: "dockerO", 
.docker . network. .ntu": "1500" 


"Labels": {} 
} 


emo@ubuntudemo :^$ 
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Now let's run a container and see what happens when we inspect the network again. Let's 
spin up an Ubuntu container with the following command: 


sudo docker run -it ubuntu:latest /bin/bash 


emo@ubuntudemo:~§ sudo docker run -it ubuntu:latest /bin/bash 


Now if we inspect our network name via the following command, you will now see that the 
container is attached to the bridge. 


sudo docker network inspect bridge 
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“Subnet”: "172.17.0.0/16", 
“Gateway”: "172.17.0.1" 


] 
i i 
"Internal": false, 
"Containers": { 
"8e7?b9a6dc121baíc9a9f e48542db0149e6e87b5ef e031f£518f b157517416a0447" " : 


"Nane": "suspicious blackuell", 
"EndpointID": “d30971d663e91ec2439355bb43c99613d500e35f baae1957a 
f ?4cb650f 40723" , 
"Macfddress": "02:42:ac:11:00:02", 
“[TPu4Address”: "172.17.0.2/16", 
"IPuo6fiddress": "" 
} 
Fa 
“Options”: t 
"con.docker.netuork.bridge.default bridge": "true", 
.docker .netuork.bridge.enable icc": "true", 
.docker .netuork.bridge.enable ip masquerade": "true", 
.docker.netuork.bridge.host binding ipu4": "0.0.0.0", 
.docker .netuork.bridge.name": "docker0", 
.docker .netuork.driver.mtu": "1500" 
}, 
"Labels": {} 
} 
] 
emo@ubuntudemo :^$ 
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Creating Your Own New Network 


One can create a network in Docker before launching containers. This can be done with 
the following command: 


Syntax 


docker network create --driver drivername name 


Options 


e drivername - This is the name used for the network driver. 


e name - This is the name given to the network. 


Return Value 


The command will output the long ID for the new network. 


Example 


sudo docker network create --driver bridge new nw 
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Output 


The output of the above command is shown below: 


enoBubuntudemo:^S sudo docker network create --driver bridge neu nu 


'01b64dc09425cc4906e20b5e17765e3248627270686062172bf c4aec42586f e 


emo@ubuntudemo:~$ _ 


You can now attach the new network when launching the container. So let’s spin up an 
Ubuntu container with the following command: 


sudo docker run -it -network=new_nw ubuntu:latest /bin/bash 


emoPubuntudemo:^9 sudo docker run -it --netuork-neu nu ubuntu:latest /bin/bash 


And now when you inspect the network via the following command, you will see the 
container attached to the network. 


sudo docker network inspect new nw 


"Scope": "local", 
"Driver": "bridge", 
"EnableIPvu6": false, 
"IPAM": -4 
"Driver": "default", 
"Options": {}, 
"Config": [ 
1 
“Subnet”: “172.18.0.0716", 
"Gateway": "172.18.0.1/16" 


] 
3; 
“Internal”: false, 
"Containers": 1 
"38604f cAZbcb5f 78d042a8f 40f 34f a245301b2020a84c9e60278642103ca6b847"' : 


“Name”: "boring dubinsku", 
"EndpointID": "74d6b14a6393bf 3081d5d9ec012b5b?6bZead49e85a5f 664c 
621761a9e69612" , 
"Machddress": "02:42:ac:12:00:02", 
"IPu4fddress": "172.18.0.2/16", 
"IPu6fddress": "" 
H 
ie 
“Options”: €, 
"Labels": {} 
} 
] 


emo@ubuntudemo :^$ 
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22. Docker — Setting Node.js 


Node.js is a JavaScript framework that is used for developing server-side applications. It 
is an open source framework that is developed to run on a variety of operating systems. 
Since Node.js is a popular framework for development, Docker has also ensured it has 
support for Node.js applications. 


We will now see the various steps for getting the Docker container for Node.js up and 
running. 


Step 1: The first step is to pull the image from Docker Hub. When you log into Docker 
Hub, you will be able to search and see the image for Node.js as shown below. Just type 
in Node in the search box and click on the node (official) link which comes up in the search 
results. 


EB - ao x 


/ J Search- DockerHub X N 


é x | & Secure | https;//hub.docker.com/search/?isAutomated - O&isOfficial-O&page- 1 &pullCount=0&q=Node&starCount=( Yr 


Docker Store is the new place to discover public Docker content. Check it out > 


Q Node 4 1 demousr 


All 5 
ad node 3.3K 10M+ > 
a official STARS PULLS DETAILS 
EU nodered/node-red-docker 41 10K+ > 
b: al public | automated build STARS PULLS DETAILS 
fm cusspvz/node 6 500K+ > 
Connecting... = 
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Step 2: You will see that the Docker pull command for node in the details of the repository 
in Docker Hub. 


— Oo x 
@ library/node - Docker H: X 
< C | @ Secure | https://hub.docker.com/_ f {r 
Before you start to code, we recommend discussing your plans through a GitHub issue, especially tor more a 


ambitious contributions. This gives other contributors a chance to point you in the right direction, give you 


feedback on your design, and help you find out if someone else is working on the same thing 


Documentation 


Documentation for this image is stored in the node/ directory of the docker-library/docs GitHub repo. Be 


sure to familiarize yourself with the repositorys README.md file before attempting a pull request 


Docker Pull Command Li 


docker pull node 


Comments (52) 


Add Comment 


Step 3: On the Docker Host, use the Docker pull command as shown above to download 
the latest node image from Docker Hub. 


demo@ubuntudemo:~9 sudo docker pull node . 


Once the pull is complete, we can then proceed with the next step. 


demo@ubuntudemo:~S sudo docker pull node 
Using default tag: latest 
latest: Pulling from library/node 


75a822cd7888: Downloading 31.54 MB/39.73 MB 
/5a822cd7888: Pull complete 
57de64c72267: Pull complete 
4306be1e8943: Pull complete 


871436ab7225: Pull complete 
0110c26a367a: Pull complete 
1f04fe713fib: Pull complete 
?23bac39028e: Pull complete 
: sha256 :08d77f 1984cf 79739ba7c987636cb871f d69745754200e5891a0c 7ee2d9965b0 


: Downloaded newer image for node: latest 
demo@ubuntudemo :^$ 
demo@ubuntudemo :^$ 
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Step 4: On the Docker Host, let's use the vim editor and create one Node.js example file. 
In this file, we will add a simple command to display "HelloWorld" to the command prompt. 


demoBubuntudemo:^$ vim HelloWorld. js 


In the Node.js file, let’s add the following statement: 


Console.log( ‘Hello World’ ); 


This will output the “Hello World” phrase when we run it through Node.js. 


Ensure that you save the file and then proceed to the next step. 


Step 5: To run our Node.js script using the Node Docker container, we need to execute 
the following statement: 


sudo docker run -it -rm -name-HelloWorld -v *$PWD":/usr/src/app -w /usr/src/app 
node node HelloWorld.js 


The following points need to be noted about the above command: 

e The -rm option is used to remove the container after it is run. 

e Weare giving a name to the container called "HelloWorld" 

e We are mentioning to map the volume in the container which is /usr/src/app to 
our current present working directory. This is done so that the node container will 
pick up our HelloWorld.js script which is present in our working directory on the 
Docker Host. 

e The -w option is used to specify the working directory used by Node.js. 


e The first node option is used to specify to run the node image. 


e The second node option is used to mention to run the node command in the node 
container. 


e And finally we mention the name of our script. 


We will then get the following output. And from the output, we can clearly see that the 
Node container ran as a container and executed the HelloWorld.js script. 


demo?ubuntudemo:^S sudo docker run -it --rm --name-HelloWorld -u "SPUD':/usr^s ma 
Yapp -w /usr/src/app node node HelloWorld. js 

Hello World 

demo@ubuntudemo :^$ 
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23. Docker — Setting MongoDB 


MongoDB is a famous document-oriented database that is used by many modern-day web 
applications. Since MongoDB is a popular database for development, Docker has also 
ensured it has support for MongoDB. 


We will now see the various steps for getting the Docker container for MongoDB up and 
running. 


Step 1: The first step is to pull the image from Docker Hub. When you log into Docker 
Hub, you will be able to search and see the image for Mongo as shown below. Just type in 
Mongo in the search box and click on the Mongo (official) link which comes up in the search 
results. 


/ @ Search - Docker Hub x N 


€ G | @ Secure | https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=mongo&starCount *| E 


Q, mongo reate A demousr 


Repositories (4120) 


mongo 10M 
official PULLS 


mongo-express 100K+ 


Official PULLS 


mongoclient/mongoclient 
public | automated build 
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Step 2: You will see that the Docker pull command for Mongo in the details of the 
repository in Docker Hub. 


@ library/mongo - Docker: X 


-— C | @ Secure | https://hub.docker.com + 


Documentation 


Documentation for this image is stored inthe mongo/ directory of the docker-library/docs GitHub repo 
Be sure to familiarize yourself with the repository’s README.md file before attempting a pull request 


Docker Pull Command n 


docker pull mongo 


Comments (51) 


Add Comment 


Step 3: On the Docker Host, use the Docker pull command as shown above to download 
the latest Mongo image from Docker Hub. 


demo?|ubuntudemo: S sudo docker pull mongo 


demoBubuntudemo:^ S sudo docker pull mongo 
[sudo] password for demo: 

Using default tag: latest 

latest: Pulling from library/mongo 


: Already exists 
: Pull complete 
: Pull complete 
: Pull complete 
55: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
53e710c6ec29: Pull complete 
Digest: sha256:23e5cdbd9bc26a6d1ae4db8252a295d6bdba8332dec684838164d5b?7bb24384*( 
Status: Downloaded neuer image for mongo:latest 


demo@ubuntudemo :^$ 
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Step 4: Now that we have the image for Mongo, let's first run a MongoDB container which 
will be our instance for MongoDB. For this, we will issue the following command: 


sudo docker -it -d mongo 


The following points can be noted about the above command: 


e The -it option is used to run the container in interactive mode. 
e The -d option is used to run the container as a daemon process. 


e And finally we are creating a container from the Mongo image. 


You can then issue the docker ps command to see the running containers: 


demo@ubuntudemo:~9 sudo docker run -it -d mongo 
ec086eec7416e368614de631b8356f cf68eec978b01b620251cb5548b7ec7189 
deno&ubuntudemo:^$ sudo docker ps 
IMAGE COMMAND CREATED 
PORTS NAMES 


mongo "/entrypoint.sh mongo” 3 seconds ago 


Up Z seconds 2701?/tcp tender_poitras 


denoBubuntudemo:^$ _ 


Take a note of the following points: 


e The name of the container is tender_poitras. This name will be different since the 
name of the containers keep on changing when you spin up a container. But just 
make a note of the container which you have launched. 


e Next, also notice the port number it is running on. It is listening on the TCP port of 
27017. 


Step 5: Now let’s spin up another container which will act as our client which will be used 
to connect to the MongoDB database. Let’s issue the following command for this: 


sudo docker run -it -link=tender_poitras:mongo mongo /bin/bash 


The following points can be noted about the above command: 
e The -it option is used to run the container in interactive mode. 


e We are now linking our new container to the already launched MongoDB server 
container. Here, you need to mention the name of the already launched container. 


e We are then specifying that we want to launch the Mongo container as our client 
and then run the bin/bash shell in our new container. 


demoBubuntudemo:^ $9 sudo docker run -it --link-tender poitras:mongo mongo /bin/v@ 
sh 
rroote83b6ae60e866 : /1t 


You will now be in the new container. 
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Step 5: Run the env command in the new container to see the details of how to connect 
to the MongoDB server container. 


A ubuntu-latest [Running] - Oracle VM VirtualBox — o x 


File Machine View Input Devices Help 
deno@ubuntudeno :~$ 

sh 

rroot?e83b6ae60e866 :/tt env 


O0NGO PORT-tcp://172.17.0.2:2701? 

ONGO PORT 27017? TCP-tcp://172.17.0.2:27017? 

ONGO ENU MONGO UERSION-3.4.1 

ONGO_PACKAGE=mongodb-org 
PATH=/usr/ local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin 
PWD= 

ONGO PORT 27017 TCP PROTO-tcp 

ONGO_ENY_GOSU_VERSION=1.7 

OME=/root 


ONGO_PORT_27017_TCP_ADDR=172.17.0.2 
ONGO_MAJOR=3 .4 

30SU_VERS ION=1.7 
ONGO_PORT_27017_TCP_PORT=27017 
ONGO_NAME=/focused_mcc l intock/mongo 
ONGO_ENY_MONGO_PACKAGE=mongodb-org 
=/usr/bin/eny 


< 
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Step 6: Now it’s time to connect to the MongoDB server from the client container. We can 
do this via the following command: 


mongo 172.17.0.2:27017 


The following points need to be noted about the above command 


e The mongo command is the client mongo command that is used to connect to a 
MongoDB database. 


e The IP and port number is what you get when you use the env command. 


Once you run the command, you will then be connected to the MongoDB database. 
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Server has startup warnings: 

017-01-07T15:26:23.769+0000 I STORAGE  Linitandlistenl 
017-01-07T15:26:23.769«0000 I STORAGE  Linitandlistenl »** WARNING: Using the 
S filesystem is strongly recommended with the WiredTiger storage engine 
12017-01-07T15:26:23.769«0000 I STORAGE  Linitandlistenl »« See http:7 
ochub .nongodb .org/core/prodnotes-f ilesystem 

017-01-07T15:26:23.873«0000 I CONTROL  Linitandlisten]l 
2017-01-07T15:26:23.874+0000 I CONTROL Linitandlisten] WARNING: Access con 
ol is not enabled for the database. 

017-01-07T15:26:23.874«0000 I CONTROL  Linitandlisten]l Read and w 
e access to data and configuration is unrestricted. 
201?7-01-07T15 : 26:23 .874+0000 I CONTROL LCinitandlisten] 


017-01-07T15:26:23.874«0000 I CONTROL LCinitandlisten] 


2017-01-07T15:26:23.875+0000 I CONTROL  Linitandlisten]l WARNING: /sys/kerne 
n/transparent hugepage/enabled is ‘always’. 

017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] We suggest s 
ing it to ‘never’ 

2017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] 

2017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] WARNING: /sys/kerne 
m/transparent_hugepage/defrag is ‘always’. 

2017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] We suggest s 
ing it to 'never' 

017-01-07T15:26:23.875«0000 I CONTROL Linitandlisten] 

> 

< > 
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You can then run any MongoDB command in the command prompt. In our example, we 
are running the following command: 


use demo 


This command is a MongoDB command which is used to switch to a database name demo. 
If the database is not available, it will be created. 


017-01-07T15:26:23.769«0000 I STORAGE  Linitandlistenl »- WARNING: Using the 
S$ filesystem is strongly recommended with the MiredTiger storage engine 
:2017-01-07T15:26:23.769«0000 I STORAGE Linitandlisten] ** See http:^/ 
ochub .nongodb .org/core/prodnotes-f i lesustem 
017-01-07T15:26:23.873+0000 I CONTROL LCinitandlisten] 
2017-01-07T15:26:23.874+0000 I CONTROL Linitandlisten] WARNING: Access con 
ol is not enabled for the database. 
2017-01-07T15 :26:23.874+0000 I CONTROL  L[initandlisten]l Read and w 
e access to data and configuration is unrestricted. 
2017?-01-07T15 :26:23.874+0000 I CONTROL L[Linitandlisten] 
2017-01-07T15:26:23.874+0000 I CONTROL  [initandlisten]l 
017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] WARNING: /sys/kerne 
m/transparent_hugepage/enabled is ‘always’. 
2017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] We suggest s 
ting it to ‘never’ 
2017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] 
017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] WARNING: /sys/kerne 
m/transparent_hugepage/defrag is ‘always’. 
2017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] We suggest s 
ing it to ‘never’ 
017-01-07T15:26:23.875+0000 I CONTROL Linitandlisten] 
> use demo 
switched to db demo 


« > 


P e OMG $$ E Right Ctr 
Now you have successfully created a client and server MongoDB container. 


100 


pi tutorials; 


24. Docker — Setting NGINX 


NGINX is a popular lightweight web application that is used for developing server-side 
applications. It is an open-source web server that is developed to run on a variety of 
operating systems. Since nginx is a popular web server for development, Docker has 
ensured that it has support for nginx. 


We will now see the various steps for getting the Docker container for nginx up and 
running. 


Step 1: The first step is to pull the image from Docker Hub. When you log into Docker 
Hub, you will be able to search and see the image for nginx as shown below. Just type in 
nginx in the search box and click on the nginx (official) link which comes up in the search 
results. 


@ Search - Docker Hub x N 


< G | & Secure | https;//hub.docker.com/search/?isAutomated - O&isOfficial-O&page- 1 &pullCount-0&q-nginx&starCount-( r 


Docker Store is the new place to discover public Docker content. Check it out > 


Q nginx Create ME demousr 
Repositories (14325) 
All < 
ad nginx 5.0K 10M+ > 
a» official STARS PULLS DETAILS 
A jwilder/nginx-proxy 908 5M+ > 
a public | automated build STARS PULLS DETAILS 
„5 webdevops/nginx 7 10K+ > 
a public | automated build AD D NETA id 


Step 2: You will see that the Docker pull command for nginx in the details of the 
repository in Docker Hub. 
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= o x 
@ library/nginx - Docker H X 
— C | @ Secure | https://hub.docker.com/_/n r 
purrrequests, amu uu Uur VEY process MONT G3 TASAS we CUT = 
Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more 
ambitious contributions. This gives other contributors a chance to point you in the right direction, give you 
feedback on your design, and help you find out if someone else is working on the same thing 
Documentation for this image is stored in the nginx/ directory of the docker-library/docs GitHub repo 
Be sure to familiarize yourself with the repository’s README.md file before attempting a pull request 
Docker Pull Command n 


docker pull nginx 


Comments (73) 


Add Comment 


Step 3: On the Docker Host, use the Docker pull command as shown above to download 
the latest nginx image from Docker Hub. 


demo@ubuntudemo:~9 sudo docker pull nginx 
Using default tag: latest 
latest: Pulling from library/nginx 


?5a822cd7888: Already exists 

Oaefb9dc4a57: Pull complete 

046e44ee6057: Pull complete 

Digest: sha256:fab482910aae9630c93bd24f c6f cecb9f 9f 792c24a8974f 5e46d8ad625ac235 
Status: Downloaded newer image for nginx:latest 

Memo@ubuntudemo:~$ _ 


Step 4: Now let’s run the nginx container via the following command: 


sudo docker run -p 8080:80 -d nginx 


We are exposing the port on the nginx server which is port 80 to the port 8080 on the 
Docker Host. 


demo@ubuntudemo:~S sudo docker run -p 8080:80 -d nginx 
[sudo] password for demo: 


605d088b4d044f 40b558f d321df Zb40cadf cdbd0c59a94?bddf f f dc0c5151e4f 
å 


deno@ubuntudemo :~$ 
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Once you run the command, you will get the following output if you browse to the URL 
http://dockerhost:8080. This shows that the nginx container is up and running. 


['] Welcome to nginx! x 


€ Q | © 192.168.1201 re 


Welcome to nginx! 


If you see this page, the nginx web server is successfully installed and 
working. Further configuration is required. 


For online documentation and support please refer to nainx.org. 
Commercial support is available at nginx.com. 


Thank you for using nginx. 


Step 5: Let's look at another example where we can host a simple web page in our ngnix 
container. In our example, we will create a simple HelloWorld.html file and host it in our 
nginx container. 


Let's first create an HTML file called HelloWorld.html 


demo@ubuntudemo:~9 sudo vim HelloUorld.html 


Let's add a simple line of Hello World in the HTML file. 
Hello World 


Let's then run the following Docker command. 


sudo docker run -p 8080:80 -v “$PWD”:/usr/share/nginx/html:ro -d nginx 


The following points need to be noted about the above command: 


e Weare exposing the port on the nginx server which is port 80 to the port 8080 on 
the Docker Host. 


e Next, we are attaching the volume on the container which is 
/usr/share/nginx/html to our present working directory. This is where our 
HelloWorld.html file is stored. 
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demo@ubuntudemo:~9 sudo docker run -p 8080:80 -u 
-d nginx 


SPUD" :"usr/share/ng inx/htnl : 


bee9ef 3f b04f Zf 3a219f c60123989351c6344074a32a765340491f 28ad3dbc44 
demo@ubuntudeno :^$ 
demo@ubuntudemo:~§ sudo docker ps 
IMAGE COMMAND CREATED 
PORTS NAMES 


ng inx “nginx -g ‘daemon off" About a minut 
443/tcp, 0.0.0.0:8080->80/tcp agitated_leavitt 
mongo “zentrypoint.sh mongo” About an hour 
Up About an hour 27017?^/tcp tender poitras 
denmo&ubuntudemo:^$ _ 


Now if we browse to the URL http://dockerhost:8080/HelloWorld.html we will get the 


following output as expected: 


= o x 
D 192.168.1.201:8080/He x 
= Œ | © 192.168.1.201:8080/Hello " * 
Hello World 
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25. Docker — Docker Toolbox 


In the introductory chapters, we have seen the installation of Docker toolbox on Windows. 
The Docker toolbox is developed so that Docker containers can be run on Windows and 


MacOS. The site for toolbox on Windows is https://docs.docker.com/docker-for-windows/ 


/ 4 Get started with Docker X \ 


< ce | @ Secure | https://docs.docker.com/docker-for-windows/ 


ä docker 


Welcome to the Docs 


"m" Get started with Docker for 
Dócker Engine WI nd OWS 


Docker for Mac . 
Estimated reading time- 27 minutes 


Docker for Windows Welcome to Docker for Windows! 


Docker is a full development platform for creating containerized apps, and Docker 
for Windows is the best way to get started with Docker on Windows systems. 


Getting Started 


Logs and Troubleshooting 


Already have Docker for Windows? If you already have Docker for 
Windows installed, and are ready to get started, skip down to Step 3. 
Check versions of Docker Engine, Compose, and Machine to work through 
the rest of the Docker for Windows tour, or jump over to the standard 
Getting Started with Docker tutorial. 


FAQs 


Example Applications 


Open Source Licensing 


For Windows, you need to have Windows 10 or Windows Server 2016 with Hyper-V 
enabled. 


The toolbox consists of the following components: 


e Docker Engine - This is used as the base engine or Docker daemon that is used 
to run Docker containers. 


e Docker Machine for running Docker machine commands. 
e Docker Compose for running Docker compose commands. 
e Kinematic - This is the Docker GUI built for Windows and Mac OS. 


e Oracle virtualbox 
Let’s now discuss the different types of activities that are possible with Docker toolbox. 
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Running in Powershell 


With Docker toolbox on Windows 10, you can now run Docker commands off powershell. 
If you open powershell on Windows and type in the command of Docker version, you will 
get all the required details about the Docker version installed. 


E3 Administrator: Windows PowerShell = im] x 


Windows PowerShe 
Copyright (C) 2016 Microsoft Corporation. All rights reserved. 


22255 
ee ee 
Go vers j goi.6.4 
Git commit: — 7392c3b 
Built: Fri Dec 16 06:14:34 2016 
OS/Arch: windows /amd64 


1.12.5 
1.24 
go1.6.4 
Git commi 7392c3b 
Built: Fri Dec 16 06:14:34 2016 
0 ch: Tinux/amd64 
NDOWS\system32> 


Pulling Images and Running Containers 


You can also now pull Images from Docker Hub and run containers in powershell as you 
would do in Linux. The following example will show in brief the downloading of the Ubuntu 
image and running of the container off the image. 


The first step is to use the Docker pull command to pull the Ubuntu image from Docker 
Hub. 


E3 Administrator: Windows PowerShell — LI x 


PS C:\WINDOWS\system32> docker pu ubuntu 
Using default tag: latest 
latest: Pulling from library/ubuntu 


b3eic725a85f: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
: Pull complete 
st: sha256:7a64bc9c8843b0a8c8b8a7e4715b7615e4e1b0d8ca3c7e7a76ec8250899c397a 
aded newer image for ubuntu:latest 


The next step is to run the Docker image using the following run command: 


docker run -it ubuntu /bin/bash 


You will notice that the command is the same as it was in Linux. 


EX root@67a51e497413: / = oO x 


PS C:\WINDOWS\system32> docker pu 
Using default tag: latest 
latest: Pulling from library/ubuntu 


b3eic725a85f: Pull complete 
daad8bdde31: Pull complete 
63fe8c0068a8: Pull complete 


i4a70713c436f: Pull complete 
bd842a2105a8: Pull complete 
i : sha256:7a64bc9c8843b0a8c8b8a7e4715b7615 e4e1b0d8ca3c7e7a76ec8250899c397a 
Downloaded newer image for ubuntu:latest 
NDOWS\system32> docker run ubuntu /bin/bash 
root@67a51e497413:/# 
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Kitematic 
This is the GUI equivalent of Docker on Windows. To open this GUI, go to the taskbar and 
on the Docker icon, right-click and choose to open Kitematic. 


About Docker... 
Check for Updates... 


Settings... 


Documentation... 
Diagnose & Feedback... 


! 


Exit Docker 


^ a (cp 


It will prompt you to download Kitematic GUI. Once downloaded, just unzip the contents. 
There will be a file called Kitematic.exe. Double-click this exe file to open the GUI 
interface. 


You will then be requested to log into Docker Hub, enter through the GUI. Just enter the 
required username and password and then click the Login button. 


Connect to Docker Hub 
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Once logged in, you will be able to see all the images downloaded on the system on the 
left-hand side of the interface. 


solr A elastcsearch 


ubuntu-upstart memcachied 


On the right-hand side, you will find all the images available on Docker Hub. 


postgres 


raiotitmq 


n 
if [LI fettunkd d minecraft 


Let's take an example to understand how to download the Node image from Docker Hub 
using Kitematic. 


Step 1: Enter the keyword of node in the search criteria. 


c x | 

" .| 
T de| Al 

Other Rep n 

i : i ais B : 

li i i É - 

É : i f B : 

node ul node i node-opencw 
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Step 2: Click the create button on official Node image. You will then see the image being 
downloaded. 


Once the image has been downloaded, it will then start running the Node container. 


CONTAINER LOGS 
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Step 3: If you go to the settings tab, you can drill-down to further settings options, as 
shown below. 


e General settings - In this tab, you can name the container, change the path 
settings, and delete the container. 


jetting 


e Ports - Here you can see the different port mappings. If you want, you can create 
your own port mappings. 


atting 
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e Volumes - Here you can see the different volume mappings. 


Em -oNNM 
e Advanced - It contains the advanced settings for the container. 
cM 
] 
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26. Docker — Setting ASP.Net 


ASP.Net is the standard web development framework that is provided by Microsoft for 
developing server-side applications. Since ASP.Net has been around for quite a long time 
for development, Docker has ensured that it has support for ASP.Net. 


In this chapter, we will see the various steps for getting the Docker container for ASP.Net 
up and running. 


Prerequisites 


The following steps need to be carried out first for running ASP.Net. 


Step 1: Since this can only run on Windows systems, you first need to ensure that you 
have either Windows 10 or Window Server 2016. 


Step 2: Next, ensure that Hyper-V is and Containers are installed on the Windows system. 
To install Hyper-V and Containers, you can go to Turn Windows Features ON or OFF. Then 
ensure the Hyper-V option and Containers is checked and click the OK button. 


II Windows Features — Oo x 


Turn Windows features on or off Q 


To turn a feature on, select its check box. To turn a feature off, clear its 
check box. A filled box means that only part of the feature is turned on. 


m) .NET Framework 3.5 (includes .NET 2.0 and 3.0) ^ 
[M] | .NET Framework 4.6 Advanced Services 
[| Active Directory Lightweight Directory Services 
[7] | Containers 
O| | Data Center Bridging 
[.] , Device Lockdown 
ML Hyper-V 
[7] | Internet Explorer 11 
LIN Internet Information Services 
CL] Internet Information Services Hostable Web Core 
[|_| Legacy Components 


The system might require a restart after this operation. 


Step 3: Next, you need to use the following Powershell command to install the 1.13.0- 
rc4 version of Docker. The following command will download this and store it in the temp 
location. 


Invoke-WebRequest "https://test.docker.com/builds/Windows/x86 64/docker-1.13.0- 
rc4.zip" -OutFile "$env:TEMP\docker-1.13.@-rc4.zip" -UseBasicParsing 
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EX Administrator: Windows PowerShell — o x 


Copyright (C) 2016 Microsoft Corporation. All rights reserved. 


> Invoke-WebRequest 


Step 4: Next, you need to expand the archive using the following powershell command. 


Expand-Archive -Path "$env:TEMP\docker-1.13.0-rc4.zip" -DestinationPath 
$env:ProgramFiles 


EX Administrator: Windows PowerShell = Oo x 
| 
e 
yright (C) 2016 Microsoft Corporation. All rights reserved. 
: \WINDOWS\system32> Invoke-WebRequest 


stem32> Expand-Archive $env: TEMP $env:ProgramFiles 
NDOWS\system32> 


Step 5: Next, you need to add the Docker Files to the environment variable using the 
following powershell command. 


$env:path += ";$env:ProgramFiles\Docker" 


Step 6: Next, you need to register the Docker Daemon Service using the following 
powershell command. 


dockerd --register-service 


Step 7: Finally, you can start the docker daemon using the following command. 


Start-Service Docker 


Use the docker version command in powershell to verify that the docker daemon is 
working. 

E Administrator: Windows PowerShell = Oo x 
PS C:\WINDOWS\system32> docker version 


Version: 1.13.0-rc4 
API version: : | 
Go version: 

Git commit: 

Built: Sat Dec 17 01:34:17 2016 
OS/Arch: windows /amd64 


version 1.24) 


Sat Dec 17 01:34:17 2016 
windows /amd64 
: false 
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Installing the ASP.Net Container 


Let's see how to install the ASP.Net container. 


Step 1: The first step is to pull the image from Docker Hub. When you log into Docker 
Hub, you will be able to search and see the image for Microsoft/aspnet as shown below. 
Just type in asp in the search box and click on the Microsoft/aspnet link which comes up 
in the search results. 


Search - Docker Hub x 


€- X @ Secure http hub.docker.com I tor 1 ff t ] ta m 0 *r 


Repositories (1314) 


pacumn/asr ) » 
public tomated I j DETAIL 
mi ofVaspnel | > 
public ! t 
ul n pnelcor » 
public ted Ot 
E nin » 
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Step 2: You will see that the Docker pull command for ASP.Net in the details of the 
repository in Docker Hub. 


— o x 
microsoft/aspnet » Doch X 
€ X | @ Secure | https//hub.docker.com/r/microsoft/aspnet Yt 
á 
You can read documentation for ASP NET, including Docker usage in the NET docs. The docs are also 
itHub. Contributions are welcomel 
Docker Pull Command Lb 
docker pull microsoft/aspnet 
Owner 


-H microsoft 


Source Repository 


o net 1e1-docker 


Connecting X 


Step 3: Go to Docker Host and run the Docker pull command for the microsoft/aspnet 
image. Note that the image is pretty large, somewhere close to 4.2 GB. 


E3 Administrator: Windows PowerShell — Oo x 


PS C:XWI syste microsoft/aspnet m 


microsoft/aspnet 
Pull complete 
Pull complete 
Pull complete 
61784b745c2 Pull complete 
d05122f129 Pull complete 
Pull complete 
48e6b45a43bc58e71da3d20d 9c29cc1c7ce87ed06ad257c4150e5286ade3 


ynloaded newer image for micr t/aspnet:latest 
tem32» 


Step 4: Now go to the following location https://github.com/Microsoft/aspnet-docker and 
download the entire Git repository. 


Step 5: Create a folder called App in your C drive. Then copy the contents from the 
4.6.2/sample folder to your C drive. Go the Docker File in the sample directory and issue 
the following command: 


docker build -t aspnet-site-new -build-arg site root-/ 


The following points need to be noted about the above command: 


e It builds a new image called aspnet-site-new from the Docker File. 


e The root path is set to the localpath folder. 
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E Administrator: Windows PowerShell = o x 
{2016 11:54 AM 


pp> cd 4.6.2 
pp\4.6.2> dir 


Directory: C:\App\4.6.2 


LastWriteTime 


1/15/20 8:52 
11/3/2016 11:54 AM Dockerfile 


.2> cd sample 
.2\sample> dir 


C:\App\4. 6. 2\sample 


LastwriteTime 


11/3/2016 11:54 AM Dockerfile 


PS C:\App\4.6.2\sample> docker build aspnet-site-new --build-arg site root-/ . 
Sending build context to Docker daemon 2.048 kB 
Step 1/3 : FROM microsoft/aspnet 
---» 08897a3b116a 

3 : ARG site root-. 

sing cache 

4c89cbibef2d 
Step 3/3 : ADD $[site root] /inetpub/wwwroot 
---» dice3a0calbc 
Removing intermediate container 8652c844e52a 
Successfully built dice3a0caibc 
PS C pp\4. 6. 2\sample> 


Step 6: Now it’s time to run the container. It can be done using the following command: 


docker run -d -p 8000:80 -name my-running-site-new aspnet-site-new 


E3 Administrator: Windows PowerShell = LI x 


PS C:\App\4.6.2\sample> docker run 8000:80 --name my-running-site-new aspnet-site-new 
31cfe55892ba5059330ae50845 32cc3cb8a31a64b69d9478a899c33f1c2ec629 
PS C:\App\4. 6. 2\sample> 


Step 7: You will now have IIS running in the Docker container. To find the IP Address of 
the Docker container, you can issue the Docker inspect command as shown below. 


E3 Administrator: Windows PowerShell $e o x 


0 --name my-running-site-new aspnet-site-new 
/83899c33fic2ec629 
\ my-running-site-new 
72.20.130. 68 
PS C:\App\4. 6. 2\sample> 
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The Docker Cloud is a service provided by Docker in which you can carry out the following 
operations: 


e Nodes — You can connect the Docker Cloud to your existing cloud providers such 
as Azure and AWS to spin up containers on these environments. 


e Cloud Repository — Provides a place where you can store your own repositories. 


e Continuous Integration — Connect with Github and build a continuous 
integration pipeline. 


e Application Deployment — Deploy and scale infrastructure and containers. 


e Continuous Deployment — Can automate deployments. 


Getting started 
You can go to the following link to getting started with Docker Cloud: 
/ BH a [m] x 
/ * Docker Cloud - Build, Sh Xx \ A 
c X | & Secure || fi lo m| * 


a docker cloud Pricing ^ Resources Signup Sign in 


Docker Cloud 


The hosted service for continuously delivering Docker 


applications. 


New to Docker? 


Create your free Docker ID to get started. 
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Once logged in, you will be provided with the following basic interface: 


@ Docker Cloud x 


€ © | & Secure | https;//cloud.docker.com/app/demousr/dashboard/onboarding/cloud-reqgistiy ? yr 


Get Help > gs demousr + 


=) Welcome to Docker Cloud! 


Let's get you familiarized with the central concepts of Docker Cloud 


Cloud registry Continuous integration Application deployment 
Continuous deployment Teams & Organizations 
oh 
=| 
E J 
Cloud registry 
Create and share private image repositories securely with your teams, or make them public tà 
a ü share them with the entire community 
L| 


When should | use the Cloud Registry? 


Connecting to the Cloud Provider 


The first step is to connect to an existing cloud provider. The following steps will show you 
how to connect with an Amazon Cloud provider. 


Step 1: The first step is to ensure that you have the right AWS keys. This can be taken 
from the aws console. Log into your aws account using the following link - 
https://aws.amazon.com/console 


GP AWS Management Con x 


€ > c @ Secure https //aws.,amazon.com/consol« wv 


amazon English ~ My Account ~ 
web services 


AWS Management Console 


B^ T$ à service 
AWS Console , Access and manage Amazon Web Services 
ML apy ix "v" Manage Your AWS 
AWS Console Mobile through a simple and intuitive web-based Resources 
^ x ? j AL 
PP user interface. You can also use the AWS 
FAQ: > Sign in to the 
" 


Console mobile app to quickly view 


Consolo 
resources or the go. 
AELATED Lil ich 


Documentation 


Articles & Tutorials 
Developer Tools Featu res 


Public Data Sets 1 
iaai Administer your AWS account 
Amazon Maohine 


images (AMIs) The Console facilitates cloud management for all aspects of your AWS account, 


including monitoring your monthly spending by service, managing seourity 
Videos & Webinars 
credentials, or even setting up new IAM Users. 


What's New = 
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Step 2: Once logged in, go to the Security Credentials section. Make a note of the access 
keys which will be used from Docker Hub. 


Y IAM Management Cons X 


€ Q | à Secure | https//consoleaws.amazon.com/iam/home?rs nzus-east- 19 /socurit dential Q Yr L 


Services ~ Resource Groups ~ G Alan * Global * — Support ~ 


^ 
4 - Access Keys (Access Key ID and Secret Access Key) 
Dashboard You use access keys to sign programmatic requests to AWS services. To learn how to sign requests using your access 
keys, see the signing documentation. For your protection, store your access keys securely and do not share them, In 
Groups addition, AWS recommends that you rotate your access keys every 90 days 
Users Note You can have a maximum of two access keys (active or Inactive) at a time 
Roles Last Last 
Polici Created Deleted Access Key ID Lost Used Used Used Status Actions 
— Region Service 
Identity providers ran AKIAIMKAPHESJUMBYTJQ N/A N/A — N/A Active Make Inactive | 
é Hele 
Account settings oS AKIAJSG7VMJGTSKJOGKA N/A N/A NA Active Make Inactive | 
" i i 2016 Delete 
Cracantiat repor Dec 12th — Jan 7th 2016-12-12 03.04 
é . C zT MIA ev werte "us-west-2  ec2 slete 
2016 2017 AKIAIRAKGUZ7VVOPALXA PST us-west-2  ec2 Deleted 
71h MA LY , 
qnn Dec at" AKIAIRSTRFGTO7BPMF3A N/A NA NA Deleted 
Encryption keys T hal 
A Important Change - Managing Your AWS Secret Access Keys 
As described in à previous announcement, you cannot retrieve the existing secret access keys for your 
AWS root account, though you can still create à new root access key at any time. As a best practice 
we recommend creating an IAM user that has access keys rather than relying on root access keys a 
r 


Step 3: Next, you need to create a policy in aws that will allow Docker to view EC2 
instances. Go to the profiles section in aws. Click the Create Policy button. 


= o x 
Ẹ IAM Management Cons: X 
€ C | @ Secure | https://console.aws.amazon.com/iam/home?region=us-east-1#/policies Q* : 
Services ~v Resource Groups + f Global ~ Support ~ 
earch IAM « Policy Actions ~ 2 | | O 
Dashboard Filter: Policy Type ~ Showing 242 results 
Groups 
"T Policy Name + Attached Entities + Creation Time + Edited Time + 
Roles () Wm  AmazonS3FullAccess 1 2015-02-06 10:40 PST 2015-02-06 10:40 
Policies g Cloudwatchdemo 1 2016-12-13 08:43 PST 2016-12-13 08:43 
Identity providers () WW  AdministratorAccess 0 2015-02-06 10:39 PST 2015-02-06 10:39.. 
Account settings () We  AmazonAPlGateway.. 0 2015-07-09 10:34 PST 2015-07-09 10:34 
Credential report () Wm AmazonAPiGateway 0 2015-07-09 10:36 PST 2015-07-09 10:36. 
(C) Wm  AmazonAPIGateway.. 0 2015-11-11 15:41 PST 2015-11-11 15:41.. 
Encryption keys () Wü  AmazonAppStreamF.. 0 2015-02-06 10:40 PST 2015-02-06 10:40... 
() Wm  AmazonAppStreamR 0 2015-02-06 10:40 PST 2016-12-07 13:00 
() Wü  AmazonAppStreamS 0 2016-11-18 20:17 PST 2016-11-18 20:17.. 
() Wi  AmazonAthenaFullA 0 2016-11-30 08:46 PST 2016-11-30 08:46.. 
M Sa AmazanCnnnitaNev n 2015-03-24 10:22 PST 2015-03-24 10:22 x 
‘ » 
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Step 4: Click on 'Create Your Own Policy' and give the policy name as dockercloud- 
policy and the policy definition as shown below. 


"Version": "2012-10-17", 
"Statement": [ 
{ 
"Action": [ 
"ec2:*", 
"iam:ListInstanceProfiles" 
l 
"Effect": "Allow", 


"Resource": "*" 


= Oo x 
€ IAM Management Cons: X 
= C | @ Secure | https://console.aws.amazon.com/iam/home?region=us-east-1#/policies Q * 
Services v Resource Groups ~  * A Aanv Global~ Support v 
Review Policy 
Step 1 : Create Policy Customize permissions by editing the following policy document. For more information about the access policy language. 


see Overview of Policies in the Using IAM guide. To test the effects of this policy before applying your changes, use the 


Step 2 : Set IAM Policy Simulator 


Permissions 


Step 3 : Review Policy — 


dockercloud-policy 


Description 


Policy Document 
* 
"Version": "2012-10-17", 
"Statement": [ 
{ 
"Action": [ 
"ere To. 
"iam:ListInstanceProfiles" 


] 


"Effect": "Allow", 
"Resource": "*" 


) - 


- d 


(v) Use autoformatting for policy editing Cancel Validate Policy Previous Create Policy 


Next, click the Create Policy button. 
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Step 5: Next, you need to create a role which will be used by Docker to spin up nodes on 
AWS. For this, go to the Roles section in AWS and click the Create New Role option. 


-— o x 
V IAM Management Cons: X 
€ C | â Secure | httpz//console.aws.amazon.com/iam/home?regi t-19 í Q ú 
Services ~ Resource Groups ~ * A Aan» Globali» Support ~ 
P Create New Role Role Actions = c o o 

Dashboard Showing 1 results 
Groups 

U [ ] Role Name $ Creation Time $ 

sars 
Roles [ ] cloudwatch 2016-12-13 08.53 PST 


Policies 
Identity providers 
Account settings 


Credential report 


Encryption keys 


Step 6: Give the name for the role as dockercloud-role. 


— o x 
€ IAM Management Cons: X 
€ C | & Secure | https://console.aws.amazon.com/iam/home?region=us-east-1#/roles Q * 
Services ~ Resource Groups ~v  * A  Aan* = Global» Support ~ 


ite Role Set Role Name 


Step 1 : Set Role Name Enter a role name. You cannot edit the role name after the role is created 


Role Name | dockercloud-role| 
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Step 7: On the next screen, go to 'Role for Cross Account Access' and select "Provide 
access between your account and a 3rd party AWS account" 


V IAM Management Cor x 


€ © | @ Secure | https://console,aws.amazon.com/iarn/! 1 us-east- 14 Q ú 


Services ~ Resource Groups =~ * UR . Global = — Support * 


Select Role Type 


Step 1- Set Role AWS Service Roles 
Name 


" lä] Role for Cross-Account Access 
Step 2 : Select Role 


Typo 
} Provide access between AWS accounts you own < 
: * Select 
Allows IAM users from one of your other AWS accounts to access this account 
| Provide access between your AWS account and a 3rd party AWS account 
Allows IAM users from a 3rd party AWS account to access this account and enforces use of External Select 


Role for Identity Provider Access 


Cancel Previous | MextStep | 


Step 8: On the next screen, enter the following details: 


e In the Account ID field, enter the ID for the Docker Cloud service: 689684103426. 


e In the External ID field, enter your Docker Cloud username. 


[m] x 
€ IAM Management Con x 
x @ Secure https//console.awsamazon.com/ia t we?r ( te Qq H 
r : 
Enter the ID of the 3rd party AWS account whose IAM users will be able to access this account Enter the external ID 
provided by the 3rd party For detalles, sae About the External ID 
Step 1 Set Role 
isthe T Account ID: 68968410342«€ 
Step 2 Select Role 
Typo Extornal ID: demous! 


Step 3 : Establish Trust Require MFA: 


Cancel Previous Next Step 
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Step 9: Then, click the Next Step button and on the next screen, attach the policy which 


was created in the earlier step. 


V IAM Management Coni X 


é Q | @ Secure 


https 


| ii Attach Policy 


/console.aws.amazon.com/ia n ! . f t-1# 


Creation Time $ 


2016-02-08 15:15 PST 


Showing 2 results 


* 


Edited Time $ 


2016-06-06 16:4 


Step 1. Set Role Select one or more policies to attach. Each role can have up to 10 policies attached 
Name 
Step 2 : Select Role 
Type Filter: Policy Type = docker 
Step 3. Establish Trust 
: Policy Name $ Attached Entities + 
Step 4 : Attach Policy 
L] Ww» AWSElasticBeansta 0 
lvl dockercloud-pollcy 0 


2017-01-07 11 26 PST 


2017-01-07 112 


Cancel 


Previous Next Step 


Step 10: Finally, on the last screen when the role is created, make sure to copy the arn 


role which is created. 


arn:aws:iam: :085363624145:role/dockercloud-role 


er NIRS nT can SE EAT OS RD Nero ere wo) 


Review 


Set Hole 


itep 1 
Name tat 
ne finish 


Step 2. Select Role Role Name 


Type 

: Role ARN 
Step 3 Establish Trust 
Step 4 |. Attach Policy Trusted Entities 
Step 5 : Review Policios 


Give this link to 
users who can 
switch roles in the 
console 
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am aws iam 085363624145 role/dockercloud 
role 


The account 689684103426 


am: aws lam 085363624145 pollcy/dockerclou 
d-pollcy 


https //slgnin. aws. amazon com/switchrole'? 
account-z085363624145&roleNamezdockerclo 
ud-role 


Review the following role information. To edit the role. click an edit link, or click Create Role to 


Edit Role Name 


Change Policies 


Copy Link 


Cancel 


Previous Create Role 
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Step 11: Now go back to Docker Cloud, select Cloud Providers, and click the plug 
symbol next to Amazon Web Services. 


N À 
— 


-+ Get Help ~v 3 demousr v 


Cloud Settings 


General 


Cloud providers demousr 
Member since Dec 17, 2016 


Source providers 
Notifications 


Default Privacy 
Cloud providers 


Billing 
Amazon Web 


F A dential: í Free Tie! 
Savia dd new credentials Y ree Tier 


Plan 
Digital Ocean Add new credentials ef L4 $20 Code 


Quotas Microsoft 


A i à i. 
ee dd new credentials L4 Free trial 


SoftLayer Add new credentials ; L4 Free trial 


Packet Add new credentials 1 54 $25 code 


Enter the arn role and click the Save button. 


Add AWS Credentials 
Don't know where or how to get this? Click here to learn more. 


arn:aws:iam::0853636241 45:role/dockercloud-role| 
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Once saved, the integration with AWS would be complete. 


@ Docker Cloud x 


€- Cc | @ Secure | https://cloud.docker.com/app/demousr/settings 


Get Help ~ * demousr * 


Cloud Settings 


General 


Cloud providers } demousr 
; Member since Dec 17, 2016 


Source providers 
Notifications 


Default Privacy 
Cloud providers 


Billing 
á Amazon Web  arn:sws:iam::085363624145:role/do Á 


Services ckercloud-role 


Digital Ocean Add new credentials f Lj $20 Code 


Microsoft 
Azure 


M free ter 


Plan 


Quotas 


Add new credentials 7 y Erga trial 
SoftLayor Add naw credentials Ww Free trial 


Packet Add new credentials 4 L1 $25 code 


Setting Up Nodes 


Once the integration with AWS is complete, the next step is to setup a node. Go to the 
Nodes section in Docker Cloud. Note that the setting up of nodes will automatically setup 
a node cluster first. 


Step 1: Go to the Nodes section in Docker Cloud. 


@ Docker Cloud x 


€ Qi | & Secure | https;//cloud.docker.com/app/demousr/nodecluster/wizard 
APPLICATIONS 
Get Help 
Stacks 


Services 


Containers Node disk 
ode disk size 


INFRASTRUCTURE 
WW Node Clusters 


B Nodes Amazon Web Servi.» 


SETTINGS 


$ Cloud settings Number of nodes 
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Step 2: Next, you can give the details of the nodes which will be setup in AWS. 


DOCKER 


d» | CLOUD -F Get Help ~v £ demousr v 


Node Clusters / Wizard 


Node disk size 
NAME Demo 


PROVIDE Amazon Web Servi..* 
REGION — ap-northeast-1 
vpes51c00c35 x 


SUBNET Auto Number of nodes 


SECURITY Auto 
GROUP 


You can then click the Launch Node cluster which will be present at the bottom of the 
screen. Once the node is deployed, you will get the notification in the Node Cluster screen. 


ecure ittps://cloud.docker.com/app/demousr/nodecluster/list/1?page_size=1 
€7 Clas | https://cloud.dock: p ist/1?pag 0 


DOCKER 


a» IUE + Get Help v 3 demousr v 


Node Clusters 


Demo 

a += ap-northeast-1 * T2.NANO - a minute va 
LÀ 

DEPLOYED 
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The next step after deploying a node is to deploy a service. To do this, we need to perform 


the following steps. 


Step 1: Go to the Services Section in Docker Cloud. Click the Create button. 


@ Docker Cloud x 
€ [e] | @ Secure | https;//cloud.docker.com/app/demousr/service/Iist/T?page size-10 ? X | 
€- Get Help ~ 2 demousr v 
BUILD 


[F] Repositories 


APPLICATIONS 

= Stacks i 
um more 

dh Services 


f=} Containers 


INFRASTRUCTURE 
WB Node Clusters 


B Nodes 


SETTINGS 


ollection of containers from the same image and share the same configuration (environment 


Step 2: Choose the Service which is required. In our case, let’s choose mongo. 


memcached 


@ Docker Cloud x 
— Cc | @ Secure | https//cloud.docker.com/app/demousr/service/wizard/image/jumpstart: 
— CACHE SERVERS ANALYTICS MISCELLANEOUS 
EZ redis eie elasticsearch r4 
LJ 
[E] dockercloud/hello-world 


DATABASE SERVERS 


m ) — 


N «ep postgres 
Va 
p” g mariadb 
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APPLICATION SERVERS 


dockercloud/authorlzedkeys 


MONITORING 


Ss 


datadog/docker-dd-agent 


(W) wordpress 
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Step 3: On the next screen, choose the Create & Deploy option. This will start deploying 


the Mongo container on your node cluster. 


/ & Docker Cloud x \ UD 


€ ~ CG |a Secure | https//cloud.docker.com/app/demousr/service/wizard/config?image s mongo 
a | E a : i -+ Get Help ~ P» 4 demousr v 
Services / Wizard 
SUMMARY 


General settings 
General settings 


IMAGE $ mongo latest 


Container configuration 


Ports 


SERVICE NAME — mongo-b6eb7b9c 
Links 


Environment variables 


NICKNAME € your service Volumes 


ADD TO STACK Select a Stack Create & Deploy 


CONTAINERS 


DEPLOYMENT 


€ > Œ |Â Secure | https;//cloud.docker.com/app/demousr/service/c7a71ef3-b476-4176-a355-a3ec93164d4d/general T? * 


DOCKER 
CLOUD + Get Help 3 demousr 


Services / mongo-b6eb7b9c —_ Scale 


General Logs Timeline 


) = STACK NAME - Q) AUTOREDEPLOY OFF 
@® IMAGETAG mongo:latest TX] AUTODESTROY OFF 
MONGO-B6EB7B9C 
X. RUN COMMAND A NETWORK bridge 
RUNNING GY SEQUENTIAL DEPLOYMENT OFF É PORTS 
Á DEPLOYMENT STRATEGY EMPTI 


GO PRIVILEGED MODE OFF 


r? AUTORESTART OFF 
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28. Docker — Logging 


Docker has logging mechanisms in place which can be used to debug issues as and when 
they occur. There is logging at the daemon level and at the container level. Let's look 
at the different levels of logging. 


Daemon Logging 


At the daemon logging level, there are four levels of logging available: 
e Debug - It details all the possible information handled by the daemon process. 
e Info — It details all the errors + Information handled by the daemon process. 
e Errors — It details all the errors handled by the daemon process. 


e Fatal — It only details all the fatal errors handled by the daemon process. 


Go through the following steps to learn how to enable logging. 


Step 1: First, we need to stop the docker daemon process, if it is already running. It 
can be done using the following command: 


sudo service docker stop 


demo@ubuntudemo:~9 sudo service docker stop 


Step 2: Now we need to start the docker daemon process. But this time, we need to 
append the -I parameter to specify the logging option. So let's issue the following 
command when starting the docker daemon process. 


sudo dockerd -1 debug & 


The following points need to be noted about the above command: 


e dockerd is the executable for the docker daemon process. 


e The -I option is used to specify the logging level. In our case, we are putting this 
as debug. 


e &isused to come back to the command prompt after the logging has been enabled. 


demo@ubuntudemo:~S sudo dockerd -1 debug & 


129 


(fp) tutorialspoint 


Docker 


Once you start the Docker process with logging, you will also now see the Debug Logs 
being sent to the console. 


IDDEBULOO011 Registering POST, /build 

IDDEBULOO011 Registering POST, /swarm/init 

IDDEBULOO011 Registering POST, /swarm/ join 

IDDEBULOO011 Registering POST, /swarm/ leave 

IDDEBULOO011 Registering GET, /swarm 

IDDEBULOO011 Registering POST, /swarm/update 

IDDEBULOO011 Registering GET, /services 

IDDEBULOO011 Registering GET, /services/tid: .*} 
IDDEBULOO011 Registering POST, /services/create 
IDDEBULOO011 Registering POST, /services/tid: .*}/update 
IDDEBULOO011 Registering DELETE, /services/tid: .*} 
IDDEBULOO011 Registering GET, /nodes 

IDDEBULOO011 Registering GET, /nodes/tid: .*} 

IDDEBULOO011 Registering DELETE, /nodes/tid: .*} 
IDDEBULOO011 Registering POST, /nodes/tid: .*}/update 
IDDEBULOO011 Registering GET, /tasks 

IDDEBULOO011 Registering GET, /tasks/tid: .*} 

IDDEBULOO011 Registering GET, /networks 

IDDEBULOO011 Registering GET, /networks/tid: .*} 
IDDEBULOO011 Registering POST, /networks/create 
IDDEBULOO011 Registering POST, /networks/tid: .*}/connect 
IDDEBULOO011 Registering POST, /networks/tid: .*}/disconnect 
IDDEBULOO011 Registering DELETE, ^netuorks^tíid:.*J 
IHFOE00011 API listen on /var/run/docker .sock 
IDDEBULOO031 libcontainerd: containerd connection state change: READY 


« > 


m» m) G 9 (9) Right Ctr 


Now, if you execute any Docker command such as docker images, the Debug information 
will also be sent to the console. 


emo@ubuntudemo:~$ sudo docker images 
IDDEBULO0891 Calling GET 7/v1.247images^/ json 
REPOS I TORY TAG IMAGE ID CREATED 
latest ?7c4489962845 3 days ago 
latest 01f818af 747d 11 days ago 
latest a3bf b96cf 65e Z ueeks ago 


latest f5792f c30aaa Z weeks ago 


latest 0e52e236368a 2 weeks ago 


latest 104bec311bcd weeks ago 
latest ff6f0851ef 5? weeks ago 


emo@ubuntudemo:~$ _ 


130 


pi tutorials; 


Docker 


Container Logging 


Logging is also available at the container level. So in our example, let's spin up an Ubuntu 
container first. We can do it by using the following command. 


sudo docker run -it ubuntu /bin/bash 


demo|ubuntudemo:^"S sudo docker run -it ubuntu /bin/bash 


root@6bf b1271fcdd:^tt demoPubuntudenmo:^$ 


demo@ubuntudemo :^$ 


Now, we can use the docker log command to see the logs of the container. 


Syntax 


Docker logs containerID 


Parameters 


e containerID - This is the ID of the container for which you need to see the logs. 


Example 


On our Docker Host, let's issue the following command. Before that, you can issue some 
commands whilst in the container. 


sudo docker logs 6bfb1271fcdd 


demoBubuntudemo: S sudo docker logs 6bfbi127?1fcdd 
rroote6bf b1271f cdd : /1t 

roote6bfbi271fcdd:^tt ifconfig 

bash: ifconfig: command not found 
root@6bfbi2z7ifcdd:7# ls 


demo@ubuntudemo :~$ 


From the output, you can see that the commands executed in the container are shown in 
the logs. 
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Docker Compose is used to run multiple containers as a single service. For example, 
suppose you had an application which required NGNIX and MySQL, you could create one 
file which would start both the containers as a service without the need to start each one 
separately. 


In this chapter, we will see how to get started with Docker Compose. Then, we will look at 
how to get a simple service with MySQL and NGNIX up and running using Docker Compose. 


Docker Compose — Installation 


The following steps need to be followed to get Docker Compose up and running. 


Step 1: Download the necessary files from github using the following command: 


curl -L "https://github.com/docker/compose/releases/download/1.10.0-rc2/docker- 
compose-$(uname -s)-$(uname -m)" -o /home/demo/docker-compose 


The above command will download the latest version of Docker Compose which at the time 
of writing this article is 1.10.0-rc2. It will then store it in the directory /home/demo/. 


eno@ubuntudemo:~$ curl -L “https://github.com/docker/compose/re leases/down loag 
1.10 .0-rc2/docker-compose-$(uname -s)-$(uname -m)" -o /home/demo/docker-compos 


Step 2: Next, we need to provide execute privileges to the downloaded Docker Compose 
file, using the following command: 


chmod +x /home/demo/docker-compose 


eno@ubuntudenmo :~ ‘https :7/github .com/docker/compose/re leases/down loaga 
1.10.0-rc2/docker-compose-S$(uname -s)-S$(uname -m)" -o /home/demo/docker-compos 
% Total % Received ~ Xferd Average Speed Time Time Time 
Dload Upload Total Spent Left 
100 600 0 600 0 0 403 0 --:--:-- 0:00:01 --:--:-- 


100 7929k 100 7929k 0 0 215k 0 0:00:36 0:00:36 --:--:-- 
enoBPubuntudemo:^S chmod +x /home/demo/docker-compose 


We can then use the following command to see the compose version. 


Syntax 


docker-compose version 
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Parameters 


e version - This is used to specify that we want the details of the version of Docker 
Compose. 


Output 


The version details of Docker Compose will be displayed. 


Example 


The following example shows how to get the docker-compose version. 


sudo ./docker-compose -version 


Output 
You will then get the following output: 


demo&ubuntudemo:^S curl -L “https://github.com/docker/compose/re leases/dounloag 

1.10 .0-rc2/docker-compose-$(uname -s)-$(uname -m)" -o /home/demo/docker-compos 
% Total % Received 7» Xferd Average Speed Tine Tine Time Curren 

Dload Upload Spent Left 

100 600 0 600 0 0 403 

100 7929k 100 7929k 0 0 215k 

demo@ubuntudemo:~§ chmod +x /home/demo/docker-compose 

demo@ubuntudemo:~§ sudo ./docker-compose version 


docker-compose version 1.10.0-rc2, build fb241d0 
docker-py version: 2.0.1 

CPuthon version: 2.7.9 

OpenSSL version: OpenSSL 1.0.1t 3 May 2016 


demo@ubuntudemo :^$ 


Creating Your First Docker-Compose File 


Now let’s go ahead and create our first Docker Compose file. All Docker Compose files are 
YAML files. You can create one using the vim editor. So execute the following command 
to create the compose file: 


sudo vim docker-compose. yml 
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services 
databases 
image: mysql 
ports 
"3306 : 3306" 


environment 


MYSQL_ROOT_PASSWORD=password 
MYSQL_USER=user 
MYSQL_PASSWORD=password 
MYSQL_DATABASE=demodb 
web 
image: nginx 


Let’s take a close look at the various details of this file: 


e The database and web keyword are used to define two separate services. One 
will be running our mysql database and the other will be our nginx web server. 


e The image keyword is used to specify the image from dockerhub for our mysql 
and nginx containers. 


e For the database, we are using the ports keyword to mention the ports that need 
to be exposed for mysql. 


e And then, we also specify the environment variables for mysql which are required 
to run mysql. 


Now let’s run our Docker Compose file using the following command: 


sudo ./docker-compose up 


This command will take the docker-compose.yml file in your local directory and start 
building the containers. 


emoBubuntudemo: S sudo ./docker-compose up 


Once executed, all the images will start downloading and the containers will start 
automatically. 
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atabases 1 i 2017-01-13T09:47:56.645558Z2 0 [Note] InnoDB: Buffer pool(s) loa 
ompleted at 170113 9:47:56 

atabases_1 i 2017-01-13T09:47:56.684579Z 0 [Warning] ‘user’ entry ’root@loca 

ignored in —-skip-name-resolve mode. 

atabases 1 i 2017-01-13T09:47:56.6847302 0 [Warning] ‘user’ entry 'musql.sus 
ocalhost' ignored in --skip-name-resolue mode. 

atabases 1 i 2017-01-13T09:47:56.684809Z2 0 [Warning] 'db' entry ‘sys mysql.s 
localhost’ ignored in --skip-name-resolvue mode. 

atabases 1 i 2017-01-13T09:47:56.684849Z 0 [Warning] 'proxies_priv’ entry '8 
pot@localhost’ ignored in --skip-name-resolue mode. 

atabases 1 i 2017-01-13T09:47:56.6883682 0 [Warning] 'tables priu' entry 'su 
onfig nysql.sus?localhost' ignored in --skip-name-resolue mode. 

atabases 1 i 2017-01-13T09:47:56.703852Z2 0 [Note] Event Scheduler: Loaded 0 


e i 2017-01-13T09:47:56.704110Z2 © [Note] Executing 'SELECT * FROM I 

DRMATION SCHEMA.TABLES;' to get a list of tables using the deprecated partitio 

engine. You may use the startup option '--disable-partition-engine-check' to s 
this check. 

atabases 1 i 2017-01-13T09:47:56.704249Z2 0 [Note] Beginning of list of non-n 


i 2017-01-13T09:47:56.729027Z © [Note] End of list of non-nativel 
i —81- :47:56.729233Z 0 [Note] mysqld: ready for connecti 


i Version: '5.7.17' socket: ’/var/run/mysqld/mysqld.sock’ port: 
306 MySQL Community Server (GPL) 


< > 
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And when you do a docker ps, you can see that the containers are indeed up and running. 


p 
2017-01-13T09 : 47 :56 .684849Z 0 [Warning] 'proxies priv' entry '8 

pot@localhost’ ignored in --skip-name-resolue mode. 

atabases 1 i 2017-01-13T09:47:56.6883682 0 [Warning] 'tables priv' entry ‘sy 
Conf ig mysql.sys@localhost’ ignored in --skip-name-resolue mode. 

atabases 1 i 2017-01-13T09:47:56.703852Z2 0 [Note] Event Scheduler: Loaded 0 
ents 

atabases 1 i 2017-01-13T09:47:56.7041102 © [Note] Executing "SELECT =~ FROM I 
DRMATION SCHEMA.TABLES;' to get a list of tables using the deprecated partitio 
engine. You may use the startup option '--disable-partition-engine-check' to s 

this check. 

atabases 1 i 2017-01-13T09:47:56.704249Z2 0 [Note] Beginning of list of non-n 
ively partitioned tables 

atabases 1 i 2017-01-13T09:47:56.729027Z © [Note] End of list of non-nativel 
partitioned tables 


i 2017-01-13T09:47?7:56.729233Z 0 [Note] mysqld: ready for connecti 


atabases 1 i Version: '5.7.17' socket: ’/var/run/mysqld/mysqld.sock’ port: 
06 MySQL Community Server (GPL) 


Stopped sudo ./docker-compose up 
emo8ubuntudemo:^S$ sudo docker ps 
IMAGE COMMAND CREATED 
PORTS NAMES 
mysql "docker-entrupoint.sh" 57 minutes ag 
Up fibout a minute 0.0.0.0:3306-»3306^tcp demo databases 1 
b45c8a2a1b4f ng inx “nginx -g ‘daemon off" fibout an hour 
o Up About a minute 807tcp, 443/tcp demo ueb 1 
eno@ubuntudeno :~ 
< » 
BOF GOSS G QE Rieht cti 
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30. Docker — Continuous Integration 


Docker has integrations with many Continuous Integrations tools, which also includes the 
popular CI tool known as Jenkins. Within Jenkins, you have plugins available which can 
be used to work with containers. So let’s quickly look at a Docker plugin available for the 


Jenkins tool. 


Let’s go step by step and see what’s available in Jenkins for Docker containers. 


Step 1: Go to your Jenkins dashboard and click Manage Jenkins. 


/ G Dashboard [Jenkins] x A | 


€ [€ | (D localhost:8080 


€ Jenkins 


Jenkins  » 


$9 New Item 


& People 
ZZ Build History 
22 Manage Jenkins 


A Credentials 


Build Queue 


No builds in the queue. 


Build Executor Status 


1 Idle 
2 Idle 
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ENABLE AUTO REFRESH 


(@add description 


Name | Last Success  LastFailure Last Duration 


Demo NA N/A N/A 3] 


Legend RSS for all RSS for failures RSS for just latest 
builds 


Page generated: Jan 13, 2017 2:39:09 AM — REST API Jenkins ver. 1.609.3 
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Step 2: Go to Manage Plugins. 


ü Manage Jenkins [Jenkin X 


€ Q | © localhost 8080/ma 
Jenkins 4 

Configure Global Security 

secure Jenkin fofine who i illowed to acce e the ystem 
Reload Configuration from Disk 
Discard all the loaded data in memory and reload everything from file 
ystem. Useful when you modified config files directly on disk 
Manage Plugins 

Add. remove. disable or enable plugins thal can extend the 
functionality of Jenkins. (updates avallable) 
System Information 
Displays various environmental information to assist trouble-shooting 
System Log 

ystem log captur output from tutil. logging output related 
to Jenkir 
Load Statistics 

Check your resource utilization and see If you need more computer 
for your bulld 

Jenkins CLI 

ACC manage enkins from your shell. or from yur ript 

Script Consola 

E cute arbitrary tipt for administration/troubl 

hooting/ diagnostic 
Manage Nodes 

Add, remove, control and monitor the various nodes that Jenkins nun 
jot on 
Manage Credentials 
Create/delete/modify the redantials that can be used by Jenkins and 
by jobs running in Jenkins te onnact to 3rd party servic 
. 


Step 3: Search for Docker plugins. Choose the Docker plugin and click the Install 
without restart button. 


g Update Center [Jenkins] X 


€ Q | © localhost:8080/p 
$$ Jenkins 


Jenkins Plugin Manager 


4 Back to Dashboard Filter: [, docker 


s. Manage Jenkins : Available 
Install | Name Version 


CloudBees Docker Build and Publish plugin 
i 1.3.2 


1.37 


your job as a build 
Quay io trigger plugin 
This plugin provide 
Quay.io d 
Docker plugin 
This plugin allows slaves to be dynam 
sing Docker 


Amazon EC2 Container Service plugin with autoscaling 
capabilities 


Use Am 


integration between Jenkins and 0.1 


0.16.1 


n ECS Containers to setup (docker-bas 


r- huile "etd 


Install without restart Download now and install after restart Update 
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Step 4: Once the installation is completed, go to your job in the Jenkins dashboard. In 
our example, we have a job called Demo. 


= oO X 
@ Dashboard [Jenkins] x 

€ Q | © localhost. w O 
$$ Jenkins 
Jenkins ENABLE AUTO REFRESH 
— New item (Wadd description 

All * 
Pn People 
5 W Name | Last Success Last Failure Last Duration 


Build History 


— Demo 23 min - #2 N/A 0 53 sec &g 
Manage Jenkins m m 


^ 
Credentials Icon 
RM Credentials SML Legend RSS for all RSS for failures RSS tor just latest 
builds 
Build Queue =a 
No builds in the queue 
Build Executor Status — 
1 Idle 
2 Idle 
Wi Help us localize this page Page generated: Jan 13, 2017 3.11:24 AM REST AP! Jenkins ver 1.09.3 


Step 5: In the job, when you go to the Build step, you can now see the option to start 
and stop containers. 


a Demo Config [Jenkins] X 


= Q | © localhost:8080/job/Demo figure *x0 
Jenkins Demo configuration x 


Keep the build logs of dependencies (2) 
Source Code Management 
*' None 
CVS 
CVS Projectset 
Subversion 
Build Triggers 
Build after other projects are built 
Build periodically 
Poll SCM 


©0000 


Build 


Add build step v 


I Add a new template to all docker clouds 
Execute Windows batch command 
Execute shell 
Invoke Ant 
Invoke top-level Maven targets 


Start/Stop Docker Containers 


m. Help us localize this page Page generated: Jan 13, 2017 2:45:37 AM REST API Jenkins ver. 1.609.3 


S 
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Step 6: As a simple example, you can choose the further option to stop containers when 
the build is completed. Then, click the Save button. 


- oO x< 
G} Demo Config [Jenkins] x 
€ Q | © localhost 0/jol I \ Yr © 
Jenkin Demo configuration . 
Bulld Iriggers 
Build after other projects are built e» 
Bulld periodically €» 
Poll SCM D 


Build 


Start/ Stop Docker Containers 


Action to choose 


Stop All Containers X 


Remove Stopped Containers 


Delete 


Add build step v 
Post-bulld Actions 


Add post-bulld action X 


Now, just run your job in Jenkins. In the Console output, you will now be able to see that 
the command to Stop All containers has run. 


Q Demo #2 Console [Jenk. X 


— QC | © localhost:8080/job/Demo/2/console t O 
€ Jenkins 


Jenkins Demo #2 


S fakio Pe @ Console Output 


“SĄ Status 
# Changes Started by user anonymous 

Building in workspace C:\Users\s362692\.hudson\jobs\Demo\workspace 
& Console Output Stopping all containers 


Finished: SUCCESS 
View as plain text 


Edit Build Information 


E 
G Delete Build 
E 


Previous Build 


E Help us localize this page Page generated: Jan 13, 2017 2:48:12 AM REST API Jenkins ver. 1.609.3 


S 
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31. Docker — Kubernetes Architecture 


Kubernetes is an orchestration framework for Docker containers which helps expose 
containers as services to the outside world. For example, you can have two services: One 
service would contain nginx and mongoDB, and another service would contain nginx 
and redis. Each service can have an IP or service point which can be connected by other 
applications. Kubernetes is then used to manage these services. 


The following diagram shows in a simplistic format how Kubernetes works from an 
architecture point of view. 


Services 


Container Container Container 


Container Container Container 


POD 


The minion is the node on which all the services run. You can have many minions running 
at one point in time. Each minion will host one or more POD. Each POD is like hosting a 
service. Each POD then contains the Docker containers. Each POD can host a different set 
of Docker containers. The proxy is then used to control the exposing of these services to 
the outside world. 
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Kubernetes has several components in its architecture. The role of each component is 
explained below: 


etcd — This component is a highly available key-value store that is used for storing 
shared configuration and service discovery. Here the various applications will 
be able to connect to the services via the discovery service. 

Flannel — This is a backend network which is required for the containers. 


kube-apiserver — This is an API which can be used to orchestrate the Docker 
containers. 


kube-controller-manager — This is used to control the Kubernetes services. 
kube-scheduler — This is used to schedule the containers on hosts. 
Kubelet — This is used to control the launching of containers via manifest files. 


kube-proxy — This is used to provide network proxy services to the outside world. 
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In this chapter, we will see how to install Kubenetes via kubeadm. This is a tool which 
helps in the installation of Kubernetes. Let's go step by step and learn how to install 
Kubernetes: 


Step 1: Ensure that the Ubuntu server version you are working on is 16.04. 


Step 2: Ensure that you generate a ssh key which can be used for ssh login. You can do 
this using the following command: 


ssh-keygen 


This will generate a key in your home folder as shown below. 


master@master:~$ ssh-keugen 

Generating public/private rsa key pair. 

Enter file in which to save the key (/home/master/.ssh/id_rsa): 
Created directory '’/home/master/.ssh’ . 

Enter passphrase (empty for no passphrase): 

Enter same passphrase again: 

Your identification has been saved in /home/master/.ssh/id_rsa. 
Your public key has been saved in /home/master/.ssh/id_rsa.pub. 
The key fingerprint is: 

SHAZ56 : a30nvüxf NvituyulJsTZRt?71keq90hrp7qUS jqgSo5u84 master@master 
The key’s randomart image is: 

+---[RSA 2048 ]----+ 


master@master:~$ _ 


Step 3: Next, depending on the version of Ubuntu you have, you will need to add the 
relevant site to the docker.list for the apt package manager, so that it will be able to 
detect the Kubernetes packages from the kubernetes site and download them 
accordingly. 


We can do it using the following commands: 


curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add - 


echo "deb http://apt.kubernetes.io/  kubernetes-xenial main” | sudo tee 
/etc/apt/sources.list.d/docker.list 
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Step 4: We then issue an apt-get update to ensure all packages are downloaded on the 
Ubuntu server. 


.com/ubuntu xenial/uniuerse amdb4 Packages , 
.archiue.ubuntu.com/ubuntu xenial/universe i386 Packages [7,512 KB] 
.archiue.ubuntu.com/ubuntu xenial/universe Translation-en [4,354 kB] 
.archiue.ubuntu.com/ubuntu xenial/multiverse amd64 Packages [144 kB] 

-archive .ubuntu.com/ubuntu xenial/multiverse i386 Packages [140 kB] 

-archive .ubuntu.com/ubuntu xenial/multiverse Translation-en [106 kB] 
.archiue.ubuntu.com/ubuntu xenial-updates/main amd64 Packages [452 kB] 
-archive .ubuntu.com/ubuntu xenial-updates/main i386 Packages [444 kB] 
.archiue.ubuntu.com/ubuntu xenial-updates/main Translation-en [178 kB] 
.archiue.ubuntu.com/ubuntu xenial-updates/restricted amd64 Packages [6,576 Bl 
.archiue.ubuntu.com/ubuntu xenial-updates/restricted i386 Packages [6,528 Bl 
.archiue.ubuntu.com/ubuntu xenial-updates/restricted Translation-en [2,016 Bl 
.archiue.ubuntu.com/ubuntu xenial-updates/universe amd64 Packages [378 kB] 
.archiue.ubuntu.com/ubuntu xenial-updates/universe i386 Packages [373 kB] 
.archiue.ubuntu.com/ubuntu xenial-updates/universe Translation-en [140 kB] 
.archiue.ubuntu.com/ubuntu xenial-updates/multiverse amd64 Packages [7,384 Bl 
.archiue.ubuntu.com/ubuntu xenial-updates/multiuerse i386 Packages [6,180 Bl 
.archiue.ubuntu.com/ubuntu xenial-updates/multiuerse Translation-en [3,080 B] 
.archiue.ubuntu.com/ubuntu xenial—backports/main amd64 Packages [4,404 Bl 
.archiue.ubuntu.com/ubuntu xenial—backports/main i386 Packages [4,404 Bl 
.archiue.ubuntu.com/ubuntu xenial—backports/main Translation-en [3,124 Bl 
.archiue.ubuntu.com/ubuntu xenial—backports/universe amd64 Packages [2,412 Bl 
.archiue.ubuntu.com/ubuntu xenial—backports/universe i386 Packages [2,412 Bl 
.archiue.ubuntu.com/ubuntu xenial—backports/universe Translation-en [1,216 Bl 


root@s laue:^it 


> 
S] P m dy G O (9) Riot c 
Step 5: Install the Docker package as detailed in the earlier chapters. 


Step 6: Now it's time to install kubernetes by installing the following packages: 


apt-get install -y kubelet kubeadm kubectl kubernetes-cni 


root@slave:"# apt-get install -y kubelet kubeadm kubectl kubernetes-cni 


kubernetes-- cni (0.3.0.1-07aBa2- 00) 
previously unselected package socat. 

to unpack .../socat 1.7.3.1-1 amd64.deb ... 
socat (1.7.3.1-1) 

previously unselected package kubelet. 

to unpack .../kubelet 1.5.1-00 amd64.deb ... 
kubelet (1.5.1-00) 

previously unselected package kubectl. 

to unpack .../kubectl 1.5.1-00 amd64.deb ... 
kubectl (1.5.1-00) 


previously unselected package kubeadnm. 
to unpack .../kubeadm_1.6.0-alpha .0-2074-a092d8e0f 95f52-00_amd64.deb ... 
kubeadm (1.6.0-alpha .0-2074-a092d8e0f 95f 52-00) 

rocessing triggers for systemd (229-4ubuntu?) 

rocessing triggers for ureadahead (0.100.0-19) 


: start and stop actions are no longer supported: falling back to defaults 

up kubernetes-cni (0.3.0.1-07a8a2-00) 
up socat (1.7.3.1-1) 
up kubelet (1.5.1-00) 
up kubectl (1.5.1-00) ... 
up kubeadm (1.6.0-alpha.0-2074-a09248e0f 95f 52-00) 

triggers for systemd (229-4ubuntu?) 

triggers for ureadahead (0.100.0-19) 

root@s lave : ^it 
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Step 7: Once all kubernetes packages are downloaded, it's time to start the kubernetes 
controller using the following command: 


kubeadm init 


ont ig file to disk: 
Lapiclient] Created API client, waiting for the control plane to become ready 
Lapiclient] All control plane components are healthy after 113.293014 seconds 
Llapiclientl Waiting for at least one node to register and become ready 
[apiclientl First node is ready after 6.502838 seconds 
[apiclientl Creating a test deployment 
Lapiclient] Test deployment succeeded 
[token-discovery] Created the kube-discovery deployment, waiting for it to become ready 
[token-discoveryl kube-discovery is ready after 55.503574 seconds 
[addons] Created essential addon: kube-proxy 
[addons] Created essential addon: kube-dns 


Your Kubernetes master has initialized successfully? 
You should nou deploy a pod netuork to the cluster. 
Run "kubectl apply -f [podnetuorkl.gaml" with one of the options listed at: 


http:/^/kubernetes.io/docs/admin/addons^/ 


You can nou join any number of machines by running the folloving on each node: 


kubeadm join —-token=101573 .ci?ba345fc84fb71 192.168.1.105 
root?Pslauve:^t — 


Once done, you will get a successful message that the master is up and running and nodes 
can now join the cluster. 


144 


Igj»tutorialepoint 


